dekun
93 lines
3.0 KiB
Markdown
93 lines
3.0 KiB
Markdown
# HyperNode-AI 部署说明
|
||
|
||
适用于 Ubuntu 22.04。脚本只安装应用本身，监听 `0.0.0.0:33333`。Nginx、Caddy 或其他反代请自行配置，上游地址使用 `127.0.0.1:33333`。
|
||
|
||
## 1. 把代码放到服务器
|
||
|
||
仓库地址：[https://git.bz121.com/dekun/HyperNode-AI.git](https://git.bz121.com/dekun/HyperNode-AI.git)
|
||
|
||
```bash
|
||
git clone https://git.bz121.com/dekun/HyperNode-AI.git
|
||
cd HyperNode-AI
|
||
sudo bash deploy/ubuntu22.sh
|
||
```
|
||
|
||
私有仓库克隆时需要你的 Gitea 账号。也可以用 scp 把整个项目目录上传到服务器，再进入该目录执行同一条命令。
|
||
|
||
## 2. 菜单
|
||
|
||
脚本是交互式的，启动后只有四个选项：
|
||
|
||
| 选项 | 作用 |
|
||
|---|---|
|
||
| 1 一键部署 | 安装 Python 依赖、创建系统用户、写入 systemd，并启动服务 |
|
||
| 2 一键卸载 | 停止服务并删除程序。数据库要再输入一次 `yes` 才会删除 |
|
||
| 3 更新 | 用当前目录的代码覆盖 `/opt/hypernode`，重装依赖并重启。`.env` 和数据库保留 |
|
||
| 4 退出 | 离开脚本 |
|
||
|
||
部署和更新结束时会请求 `http://127.0.0.1:33333/health`，失败会打印最近 50 行服务日志。
|
||
|
||
重复执行「一键部署」不会覆盖已经存在的 `/opt/hypernode/.env`，也不会删除数据库。
|
||
|
||
## 3. 安装结果
|
||
|
||
| 项目 | 位置 |
|
||
|---|---|
|
||
| 程序 | `/opt/hypernode` |
|
||
| 配置 | `/opt/hypernode/.env` |
|
||
| 虚拟环境 | `/opt/hypernode/.venv` |
|
||
| 数据库 | `/var/lib/hypernode/hypernode.db` |
|
||
| systemd | `hypernode.service` |
|
||
| 监听 | `0.0.0.0:33333`，进程数固定为 1 |
|
||
|
||
进程数必须是 1。每日清算跑在这个进程里，开多个 worker 会重复触发定时任务。
|
||
|
||
常用命令：
|
||
|
||
```bash
|
||
systemctl status hypernode
|
||
journalctl -u hypernode.service -f
|
||
curl http://127.0.0.1:33333/health
|
||
```
|
||
|
||
接口文档：`http://<服务器 IP>:33333/docs`
|
||
|
||
手动补跑某一天的清算：
|
||
|
||
```bash
|
||
sudo -u hypernode /opt/hypernode/.venv/bin/python -m app.settle --date 2026-10-09
|
||
```
|
||
|
||
不带日期时，结算上一个已经结束的 UTC 账本日。服务正常运行时，北京时间每天 00:05 会自动执行。
|
||
|
||
## 4. 反代
|
||
|
||
脚本不修改 Nginx。同一台机器上的反代把流量转到本机 33333 即可，例如：
|
||
|
||
```nginx
|
||
location / {
|
||
proxy_pass http://127.0.0.1:33333;
|
||
proxy_set_header Host $host;
|
||
proxy_set_header X-Real-IP $remote_addr;
|
||
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||
proxy_set_header X-Forwarded-Proto $scheme;
|
||
}
|
||
```
|
||
|
||
当前接口没有登录鉴权。反代若只在本机使用，云安全组不要对公网放行 33333。需要从外网直接访问时，再放行该端口，并在反代或安全组上限制来源。
|
||
|
||
## 5. 更新代码
|
||
|
||
在服务器上进入新的项目目录后重新打开菜单，选择 `3`：
|
||
|
||
```bash
|
||
cd /path/to/HyperNode-AI
|
||
sudo bash deploy/ubuntu22.sh
|
||
```
|
||
|
||
选择更新后，脚本把该目录同步到 `/opt/hypernode`，然后重启服务。
|
||
|
||
## 6. 卸载
|
||
|
||
菜单选择 `2`。先输入 `yes` 确认删除程序。是否删除 `/var/lib/hypernode` 会再问一次；直接回车会留下数据库。
|