九秋 Logo 有手就行搭建 New API 九秋会员专享
九秋会员专享

有手就行搭建 New API

从服务器、域名、Cloudflare、1Panel 开始,按顺序装好 New API, 再完成 HTTPS、反向代理和基础初始化。

低价进货上游站点推荐

推荐使用 jiuqiuai.top

稳定供货,量大价低,减少货源波动,不用一直为上游操心。

https://www.jiuqiuai.top
这一篇能帮你干嘛

把服务器、域名、面板和 New API 全部搭起来。

完成后的效果

搭出一个可以通过域名和 HTTPS 访问的 New API 后台。

建议你怎么读

照着章节顺序往下做,每做完一节就停下来检查一次。

前置准备

开工前先把东西备齐,别做到一半满世界找

先准备好这些内容

项目 用途 建议
SSH 工具 后面用来连接服务器执行命令 Xshell / FinalShell / Windows Terminal
浏览器 用来打开各个平台后台和面板页面 Chrome / Edge
耐心 卡住时逐项检查,不要一急就乱改配置 真的有用,别嘴硬

开始前检查一次,少走很多弯路

  • 浏览器可以正常使用
  • 你已经装好 Xshell 或其他 SSH 工具
  • 你知道怎么复制和粘贴命令
  • 后面步骤准备按顺序往下做,不跳着改

基础概念科普

没耐心可以先跳,卡住了别嘴硬,记得回来

服务器

就是你租的一台远程电脑,后面所有服务都装在这台机器上。

域名

域名就是网址,用来代替难记的 IP 地址。

DNS

DNS 的作用是把域名翻译成服务器 IP。

Cloudflare

帮助你管理 DNS、代理访问流量、配置 HTTPS。

SSH

用于远程连接服务器的方式,你要用它来安装 1Panel。

SSL / HTTPS

让浏览器访问地址从 http 变成更正式的 https

反向代理

把域名访问请求转发到 New API 实际运行的端口。

你现在只需要记住一件事: 域名先找到服务器,服务器上的网站入口再把请求转给 New API,这就是你后面要搭出来的完整链路。

详细步骤

正文开始:照着做就行,别自己临场加戏

开始顺序 先完成服务器、域名、Cloudflare,再进入 1Panel 和 New API。
每章结束都检查 确认当前这一章已经做通,再继续后面的操作。
容易出错的地方 NS、DNS、反向代理目标地址、证书申请顺序。

购买服务器,先有机器再谈理想

先准备一台 Linux 云服务器,后面所有安装操作都在这台机器上完成。

1.1 选择服务器地区与配置

建议优先选延迟较低、网络相对稳定的地区,例如香港、美国、日本等。配置方面,个人学习最少 1 核 1G,也更建议 1 核 2G。

如果你还没有找到合适的平台,这里放我的邀请链接: qvps.top。 这是我个人推荐,虽然是小厂,但不需要实名和备案,价格也比较合适。

点这里购买云服务器

  • 优先选择香港、美国、日本这类境外地区,不要买国内地区的机器
  • 系统优先选择 Debian 11/12 或 Ubuntu 22.04
  • 如果预算允许,优先 2G 内存
  • 一开始不必追求太高配置,够用即可

这一步图省事最容易翻车。机器买到国内,后面你还得额外处理备案相关流程。

1.2 记录服务器关键信息

购买完成后,进入服务器管理页面,记录以下内容:

  • 公网 IP
  • 登录用户名,通常是 root
  • 登录密码或密钥

后面每一步都会用到这些信息,不要丢。

不要把服务器后台截图、IP、密码、订单信息、账号邮箱直接发给别人,保护好自己的隐私,避免被有心之人利用。

购买与配置域名,先把门牌号办下来

域名是你的服务入口,后面访问服务时用的是域名,而不是直接输入 IP。

2.1 购买一个适合使用的域名

域名后缀建议优先选 .com.net。如果你只是学习搭建,也建议买一个自己能长期管理的域名。

这里推荐在 Namesilo 购买域名,原因是价格便宜、支持支付宝、免费提供 WHOIS 隐私保护。

点这里购买域名

IP 访问示例http://1.2.3.4:3000
域名访问示例https://www.example.com

买域名和配置域名时,不要把账号后台截图、邮箱、支付信息和完整订单页随手发给别人,自己的资料自己留好。

域名付好款后,下一步就去 Cloudflare 添加域名,先把后面要用到的 NS 地址拿到手。

教学截图
步骤图 域名购买1.webp 先搜索你要买的域名
教学截图
步骤图 域名结算界面1.webp 进入结算页确认域名和年限
教学截图
步骤图 域名结算界面2.webp 继续确认订单信息
教学截图
步骤图 域名结算界面3.webp 选择支付宝支付,方便操作
教学截图
步骤图 域名结算界面_优惠码.webp 有优惠码就填,没有就直接继续。这个优惠码是随便网上找的,需要就填,不需要也行,最后完成支付。

2.2 注册 Cloudflare

  1. 打开 https://dash.cloudflare.com/
  2. 注册或登录 Cloudflare 账号
  3. 点击添加域名
  4. 输入主域名,例如 example.com
  5. 选择免费计划继续

注册并添加域名完成后,Cloudflare 会给你分配两条 NS 地址。

这两条 NS 先别关,下一步马上回 Namesilo 后台把域名的 NS 记录改掉。

教学截图
步骤图 CF添加域名1.webp 进入 Cloudflare 添加域名
教学截图
步骤图 CF添加域名2.webp 输入你的主域名继续
教学截图
步骤图 CF添加域名3.webp 选择免费方案继续
教学截图
步骤图 CF添加域名4.webp 进入接入流程,准备拿 NS
教学截图
步骤图 获取NS服务器地址.webp 记下系统分配给你的两条 NS

2.3 修改 NS 记录

回到 Namesilo 后台,把原来的 Nameserver 删除,改成 Cloudflare 分配给你的两条 NS 地址。

  • 先登录 Namesilo,进入 Manage My Account
  • 找到你刚买的域名,按顺序进入管理和详细设置页面
  • 一定填你自己的 NS
  • 不要照抄别人截图里的值

这一步保存完成后,就等 Cloudflare 验证接管成功,然后再继续往下做 DNS 解析。

教学截图
步骤图 修改NS记录_1.webp 登录 Namesilo 后台,点击 Manage My Account
教学截图
步骤图 NS记录2.webp 找到域名,点击进入管理
教学截图
步骤图 修改NS记录3.webp 点击域名进入详细设置
教学截图
步骤图 回到购买域名地方_填写对应自己的NS.webp 点击编辑,把旧的删掉,再填入你自己 Cloudflare 提供的 NS 地址并保存

2.4 等待 Cloudflare 接入生效

修改 NS 后需要等待一段时间。只有当 Cloudflare 侧状态正常后,才建议继续下面的 DNS 设置。

  • 有时几分钟即可
  • 有时可能需要几小时
教学截图
步骤图 等待CF验证完成.webp 先等 Cloudflare 验证
教学截图
步骤图 CF验证成功后.webp 看到接入成功后再继续

2.5 添加 A 记录,把 www 域名解析到服务器

进入 Cloudflare 的 DNS 记录页,添加指向服务器公网 IP 的 A 记录。

类型 名称 说明
A @ 服务器公网 IP 主域名
A www 服务器公网 IP 正式访问子域名

建议先把代理打开,也就是橙色云状态。

教学截图
步骤图 添加DNS_1.webp 进入 DNS 记录页开始添加
教学截图
步骤图 添加DNS_2.webp 把主域名或 www 的 A 记录填到服务器公网 IP
教学截图
步骤图 添加DNS_3.webp 确认解析已保存,准备连服务器

安装 1Panel 面板,能点就别硬敲

1Panel 是后面最重要的图形管理界面,安装完成后,大部分操作都会在面板里完成。

3.1 使用 SSH 工具连接服务器

  1. 打开 Xshell 或其他 SSH 工具
  2. 新建连接
  3. 主机填写服务器 IP
  4. 端口填写 22
  5. 输入用户名和密码后点击连接
  6. 第一次连接时,接受并保存主机密钥
教学截图
步骤图 SSH连接服务器1.webp 新建 SSH 连接
教学截图
步骤图 SSH连接服务器2.webp 填写服务器 IP 和端口
教学截图
步骤图 SSH连接服务器3.webp 输入账号和密码连接
教学截图
步骤图 SSH账号秘密设置.webp 确认 SSH 账号和密码设置后,点击连接
教学截图
步骤图 SSH连接服务器4.webp 接受并保存主机密钥

3.2 执行 1Panel 官方安装命令

bash -c "$(curl -sSL https://resource.fit2cloud.com/1panel/package/v2/quick_start.sh)"
  • 粘贴命令后回车执行
  • 安装时大部分选项直接回车即可
  • Xshell 常见粘贴方式是 Ctrl + Shift + V
教学截图
步骤图 安装1panel1.webp 粘贴命令开始安装
教学截图
步骤图 安装1panel2.webp 跟着提示往下执行
教学截图
步骤图 安装1panel3.webp 中间选项大部分直接回车
教学截图
步骤图 安装1panel4.webp 继续等待安装完成
教学截图
步骤图 安装1panel5.webp 看到安装结果页面

3.3 保存面板地址和登录信息

安装完成后,终端会输出面板地址、用户名、密码等信息。务必保存下来。

  • 面板访问地址
  • 用户名
  • 密码
  • 如果有安全入口参数,也要一并保存

这些信息自己保存好就行,不要把完整后台地址、账号和密码截图直接转发给别人。

教学截图
步骤图 保存好1panel账号秘密.webp 把地址、账号和密码保存好

3.4 登录 1Panel 后台

把安装完成后生成的外部访问地址复制到浏览器中,用这个外部地址打开 1Panel 后台,再输入用户名和密码登录。

如果打不开,先查安全组、防火墙、端口开放情况。

教学截图
步骤图 登入1panel1.webp 登录 1Panel 后台

安装 OpenResty 和 New API,这俩一个都别漏

先把要用的应用装好,后面反向代理、证书和初始化才有地方落。

4.1 先安装 OpenResty

  1. 进入应用商店
  2. 搜索 OpenResty
  3. 打开安装页面
  4. 按默认配置安装即可
教学截图
步骤图 安装OpenResty.webp 应用商店安装 OpenResty

4.2 再安装 New API

  1. 回到应用商店
  2. 搜索 New API
  3. 打开安装页面
  4. 按页面提示完成安装
教学截图
步骤图 安装new_api.webp 应用商店安装 New API

4.3 装完先确认状态正常

  • OpenResty 已安装
  • New API 已安装
  • 如果页面提示未启动,先别急着做后面的域名和证书

如果应用没有成功启动,不要继续下面的证书和反向代理配置。

配置域名、证书与初始化,把门牌和门锁都装好

这一章完成之后,你就不再是通过端口访问,而是通过正式域名访问 New API。

5.1 先申请 SSL 证书

先进入网站证书页面,给你的域名申请 SSL 证书。申请前先确认 DNS 解析已经正确生效。

  • 域名没解析好,证书通常会失败
  • 证书成功后再正式切到 HTTPS

证书先申请好,下一步再去创建反向代理网站,后面直接配置 HTTPS 会更顺手。

教学截图
步骤图 申请SSL证书1.webp 进入证书申请页面
教学截图
步骤图 申请SSL证书2.webp 填写域名并提交申请
教学截图
步骤图 申请SSL证书3.webp 证书签发成功后绑定使用

5.2 创建反向代理网站

  1. 进入网站管理
  2. 创建网站
  3. 选择反向代理模式
  4. 填写域名
  5. 代理目标填写 New API 的服务地址和端口
  6. 把前面申请好的证书绑定到网站配置中

目标地址填错,后面域名打开就会失败。

教学截图
步骤图 创建网站反代.webp 先创建网站反向代理
教学截图
步骤图 反向代理1.webp 填写域名和反代目标
教学截图
步骤图 反向代理2.webp 确认保存反向代理配置

5.3 用域名打开 New API 并完成初始化

浏览器里尝试打开你的正式地址,例如 https://www.example.com。第一次打开后,按页面提示完成管理员初始化。

教学截图
步骤图 new_api初始化1.webp 首次打开域名后的初始化页
教学截图
步骤图 new_api初始化2.webp 填写管理员信息
教学截图
步骤图 new_api初始化3.webp 确认初始化设置
教学截图
步骤图 new_api初始化4.webp 初始化完成,准备登录后台

5.4 登录后台确认搭建完成

最后登录后台,确认首页、菜单、基础功能都能正常打开。

教学截图
步骤图 newapi_登入后台1.webp 进入后台登录页
教学截图
步骤图 newapi登入后台2.webp 登录成功,看到后台首页

基础对接配置,搭完别只会看首页

如果你要继续往下用,就需要在后台完成最基础的令牌、渠道和测试配置。

6.1 修改基础访问地址

进入后台基础设置,确认你的站点访问地址已经改成正式域名,而不是本地或临时地址。

6.2 创建令牌

这一小步先创建一个测试用令牌,先别急着配很多。它主要是给后面渠道添加完成后拿来测试调用是否正常。

6.3 添加渠道

进入渠道管理,添加你自己的上游渠道。注意选择正确的分组,并在需要时获取模型列表。渠道配好之后,再回头用上一步创建的测试令牌去验证是否能正常调用。

如果某些上游需要特殊请求头或额外参数,请按你自己的上游要求填写,不要随便照抄无关配置。

教学截图
步骤图 创建上游渠道1.webp 进入创建上游渠道页面
教学截图
步骤图 添加渠道2.webp 填写渠道基础信息
教学截图
步骤图 添加渠道3.webp 选择分组并配置模型
教学截图
步骤图 添加渠道4.webp 保存后准备测试渠道

6.4 测试渠道

渠道保存完成后,再配合前面创建的测试令牌进行调用测试。测试成功,说明你的建站和基础配置已经真正能用。

完成标准

下面这些都对上了,才算真的搭完,不是你自我感动

你应该检查的内容

  • 域名已经正确解析到服务器
  • 1Panel 能正常打开并登录
  • New API 应用状态是已启动
  • HTTPS 已经正常
  • New API 后台可以登录
  • 基础令牌和渠道可以正常测试

你最终的访问形式

https://www.你的域名.com

如果你最后仍然只能用 IP:端口 打开,那说明域名、反向代理或证书至少有一处没有完全配置好。

常见问题

卡住先看这里,很多问题真没你想得那么玄乎

域名解析不生效怎么办?

先检查 NS 是否已经切换成功,再检查 A 记录是否填成了正确的公网 IP,最后等待 DNS 生效。

1Panel 页面打不开怎么办?

优先检查安全组、服务器防火墙和面板访问端口是否已经开放。

SSL 证书申请失败怎么办?

大多数情况是域名还没有正确解析到服务器,或者证书申请域名和网站绑定域名不一致。

New API 已启动但域名打不开怎么办?

优先检查反向代理目标地址和端口,其次再看应用日志。

登录后会话异常怎么办?

优先检查 SESSION_SECRET 是否设置,并确认修改后已经重启应用。