部署:scripts/init.sh 改为纯环境变量驱动,零参数可直接运行

- 不再依赖任何外部文件;全变量可选,什么都不给也能生成并启动(admin/admin、自动探测公网 IP、platforms: [])
- 新增 UP=0(只生成 .env/config.yml,不起容器;此时不检查 docker,没装 Docker 的机器也能用)
- 环境变量优先,MCP_DIR 不存在则跳过并提示
- 输出与生成物里的措辞去掉 /root 路径硬编码(保持中性)
- docs/DEPLOY.md 第 0 节改写为「只读环境变量」的用法
This commit is contained in:
2026-09-15 20:35:29 +08:00
parent 56376bd080
commit 40fb85464d
2 changed files with 91 additions and 61 deletions
+20 -8
View File
@@ -16,25 +16,37 @@
## 0. 一键生成配置并启动(推荐)
`scripts/init.sh` 读取一组环境变量(通常由服务器上的 `/root/init_repos.sh` 从 `/root/deploy.conf` 传过来),
生成 `.env` 与 `config.yml`,然后按顺序起 agent → mcp:
`scripts/init.sh` 只读环境变量(不依赖任何外部文件),生成 `.env` 与 `config.yml`,
然后按顺序起 agent → mcp:
```bash
# 直接跑(或在仓库根:./scripts/init.sh)
# 什么都不给也能跑:用默认账号 admin/admin、自动探测公网 IP、无模型(platforms: [])
./scripts/init.sh
# 给几个变量
BIGMODEL_KEY=xxx DEEPSEEK_KEY=yyy PUBLIC_IP=1.2.3.4 ./scripts/init.sh
# 只生成 .env / config.yml,不起容器(不装 Docker 的机器也能用)
UP=0 ./scripts/init.sh
# mcp 仓库不在 ../mcp 时指定
MCP_DIR=/path/to/mcp ./scripts/init.sh
```
| 输入变量 | 说明 |
| 输入变量(均可选) | 说明 |
|---|---|
| `BIGMODEL_KEY` / `DEEPSEEK_KEY` / `QWEN_KEY` | 模型平台 key,**填几个启用几个**(可 0~3 个) |
| `BIGMODEL_KEY` / `DEEPSEEK_KEY` / `QWEN_KEY` | 模型平台 key,**填几个启用几个**(0~3 个) |
| `ZHIPU_KEY` | image-gen / video-gen 用;**留空则这两个服务 `enable: false`**(工具不加载) |
| `AUTH_USER` / `AUTH_PASSWORD` | 登录账号(默认 `admin`/`admin`,记得改) |
| `PUBLIC_IP` / `AGENT_PORT` | 对外地址与端口(`PUBLIC_IP` 空则尝试自动探测) |
| `MCP_DIR` | mcp 仓库位置(默认 `../mcp`) |
| `LOG_LEVEL` | 日志级别(默认 `debug`;日常用 `info`) |
| `MCP_DIR` / `UP` | mcp 仓库位置(默认 `../mcp`)/ `UP=0` 只生成配置 |
| `AUTH_SECRET` / `EXECUTOR_TOKEN` | 一般不用给:不给就自动生成,并**存在 `.env` 里复用**(所以重跑不会掉登录态) |
自动处理、不用配:`AUTH_SECRET` / `EXECUTOR_TOKEN`(生成一次后存进 `.env`,**重跑保持不变**,所以不会掉登录态)、`LOG_LEVEL`(脚本顶部默认 `debug`,日常改 `info`)。
⚠️ **`config.yml` 是生成物,不要再手改**:每次生成都会把旧的备份成 `config.yml.bak.<时间戳>`。
要改配置请带环境变量重跑该脚本,或者不用脚本、按第 2 节手动维护。
⚠️ **`config.yml` 是生成物,不要再手改**:每次生成都会把旧的备份成 `config.yml.bak.<时间戳>`。要改配置请改上游的 `deploy.conf` 后重跑,或者不用脚本、按第 2 节手动维护。
> 本机现成的一键流程(仓库外):`/root/deploy.conf` 放变量 → `/root/init_repos.sh`(拉仓库 → 把变量 export 出去 → 调本脚本)。
## 1. 网络(自动创建,无需手动)
+71 -53
View File
@@ -1,22 +1,30 @@
#!/bin/bash
# 由 /root/init_repos.sh 调用(也可在仓库根直接跑:./scripts/init.sh)
# init.sh — 生成 .env 与 config.yml,然后起服务(agent → mcp)。
#
# 职责:生成 .env 与 config.yml,然后按序起服务(agent → mcp)。
# 只读环境变量,不依赖任何外部文件;**全部可选**,什么都不给也能直接跑。
#
# 输入(环境变量,通常来自 /root/deploy.conf):
# BIGMODEL_KEY / DEEPSEEK_KEY / QWEN_KEY 模型平台 key,填几个启用几个(可 0~3 个)
# ZHIPU_KEY image-gen / video-gen 的智谱 key(空 = 两个服务 enable: false)
# 用法:
# ./scripts/init.sh # 全用默认值(无模型、admin/admin、自动探测公网 IP)
# BIGMODEL_KEY=xxx PUBLIC_IP=1.2.3.4 ./scripts/init.sh # 给几个变量就行
# UP=0 ./scripts/init.sh # 只生成 .env / config.yml,不起容器
# MCP_DIR=/path/to/mcp ./scripts/init.sh # mcp 仓库不在 ../mcp 时指定
#
# 输入(都可选):
# BIGMODEL_KEY / DEEPSEEK_KEY / QWEN_KEY 模型平台 key,填几个启用几个(0~3 个)
# ZHIPU_KEY image-gen / video-gen 的智谱 key(空 = 这两个服务 enable: false)
# AUTH_USER / AUTH_PASSWORD 登录账号(默认 admin / admin,请自行改掉)
# PUBLIC_IP / AGENT_PORT 对外地址与端口(PUBLIC_IP 空则尝试自动探测)
# MCP_DIR mcp 仓库位置(默认本仓库同级 ../mcp)
# LOG_LEVEL 日志级别(默认 debug;日常用 info)
# MCP_DIR mcp 仓库位置(默认本仓库同级 ../mcp;不存在就跳过)
# UP 1=生成后起服务(默认),0=只生成配置
# AUTH_SECRET / EXECUTOR_TOKEN 一般不用给:不给就自动生成并复用(见下)
#
# 自动处理(不用配;生成后存进 .env,重跑保持不变,所以不会掉登录态):
# AUTH_SECRET / EXECUTOR_TOKEN / LOG_LEVEL
#
# ⚠️ config.yml 由本脚本生成,不要手改(每次生成前会把旧的备份为 config.yml.bak.<时间戳>)。
# 要改配置请改 /root/deploy.conf 后重跑 /root/init_repos.sh。
# ⚠️ config.yml 是本脚本的生成物,不要手改(每次生成前会把旧的备份为 config.yml.bak.<时间戳>)。
set -euo pipefail
# ============================================================
# 路径与默认值
# ============================================================
REPO_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
cd "$REPO_DIR"
@@ -32,23 +40,18 @@ AUTH_USER="${AUTH_USER:-admin}"
AUTH_PASSWORD="${AUTH_PASSWORD:-admin}"
PUBLIC_IP="${PUBLIC_IP:-}"
AGENT_PORT="${AGENT_PORT:-8090}"
LOG_LEVEL="${LOG_LEVEL:-debug}" # 测试期默认 debug(打印 AI↔工具完整交互);日常用 info
LOG_LEVEL="${LOG_LEVEL:-debug}"
EXECUTOR_TOKEN="${EXECUTOR_TOKEN:-}"
AUTH_SECRET="${AUTH_SECRET:-}"
UP="${UP:-1}"
# 只用于日志里显示"配置从哪来",不影响行为
CONFIG_SOURCE="${CONF:-环境变量}"
log() { echo -e "\n\033[1;32m===== $* =====\033[0m"; }
info() { echo -e "\033[1;36m[INFO]\033[0m $*"; }
warn() { echo -e "\033[1;33m[WARN]\033[0m $*"; }
warn() { echo -e "\n\033[1;33m[WARN]\033[0m $*"; }
err() { echo -e "\033[1;31m[ERROR]\033[0m $*"; }
# ============================================================
# 1. 环境检查
# ============================================================
if ! command -v docker >/dev/null 2>&1 || ! docker compose version >/dev/null 2>&1; then
err "docker / docker compose 不可用。请先跑 /root/init.sh 完成服务器初始化。"
exit 1
fi
gen_hex() { # $1 = 字节数(默认 32)
local n="${1:-32}"
if command -v openssl >/dev/null 2>&1; then
@@ -58,8 +61,13 @@ gen_hex() { # $1 = 字节数(默认 32)
fi
}
if [ "$UP" = "1" ] && { ! command -v docker >/dev/null 2>&1 || ! docker compose version >/dev/null 2>&1; }; then
err "要起服务需要 docker + docker compose;只生成配置请用: UP=0 $0"
exit 1
fi
# ============================================================
# 2. 生成 .env(密钥只生成一次,之后复用 → 重跑不掉登录态、不改 executor token)
# 1. 生成 .env(密钥只生成一次,之后复用 → 重跑不掉登录态、不改 executor token)
# ============================================================
log "生成 $ENV_FILE"
@@ -71,7 +79,7 @@ EXECUTOR_TOKEN="${EXECUTOR_TOKEN:-$(gen_hex 32)}"
AUTH_SECRET="${AUTH_SECRET:-$(gen_hex 32)}"
cat > "$ENV_FILE" <<EOF
# 本文件由 scripts/init.sh 生成,勿手改(改配置请改 /root/deploy.conf 后重跑 init_repos.sh)
# 本文件由 scripts/init.sh 生成,勿手改(改配置请重新运行该脚本,或用环境变量覆盖)
# EXECUTOR_TOKEN: core 与 executor 之间的调用鉴权(两侧同值,compose 注入)
# AUTH_SECRET: 登录态签名密钥(写进 config.yml 的 auth.secret)
# AGENT_PORT: agent-core 映射到宿主机的端口
@@ -79,9 +87,9 @@ EXECUTOR_TOKEN=$EXECUTOR_TOKEN
AUTH_SECRET=$AUTH_SECRET
AGENT_PORT=$AGENT_PORT
EOF
info "EXECUTOR_TOKEN / AUTH_SECRET 已就位(复用旧的,或本次新生成)"
info "EXECUTOR_TOKEN / AUTH_SECRET 已就位(沿用已有 .env 的值,没有则新生成)"
# PUBLIC_IP 兜底自动探测(deploy.conf 里填了就用填的)
# PUBLIC_IP 兜底:只有没给时才去探测(探测不到只告警,不影响启动,只是图生视频用不了)
if [ -z "$PUBLIC_IP" ]; then
for u in https://ifconfig.me https://api.ipify.org; do
if command -v curl >/dev/null 2>&1; then
@@ -91,11 +99,12 @@ if [ -z "$PUBLIC_IP" ]; then
done
fi
if [ -z "$PUBLIC_IP" ]; then
warn "探测不到公网 IP:public_link 不生效(图生视频用不了)。请在 deploy.conf 里填 PUBLIC_IP 后重跑。"
warn "没给 PUBLIC_IP 也探测不到:public_link 不生效(需要外部服务来取文件的场景用不了)。"
warn "设置后重跑即可: PUBLIC_IP=<公网IP> $0"
fi
# ============================================================
# 3. 生成 config.yml
# 2. 生成 config.yml
# ============================================================
log "生成 $CONFIG_YML"
@@ -104,7 +113,7 @@ if [ -f "$CONFIG_YML" ]; then
info "旧 config.yml 已备份为 config.yml.bak.<时间戳>"
fi
# 单个平台骨架(url / 模型 / 参数固定,只有 key 来自配置)
# 单个平台骨架(url / 模型 / 参数固定,只有 key 来自变量)
emit_platform() {
case "$1" in
bigmodel)
@@ -159,13 +168,13 @@ if [ -n "$QWEN_KEY" ]; then enabled_plats+=("qwen"); fi
{
echo "# 本文件由 scripts/init.sh 生成,请勿手改!"
echo "# 改配置请改 /root/deploy.conf 后重跑 /root/init_repos.sh(本文件会重新生成,旧的留 .bak)。"
echo "# 改配置请带环境变量重新运行该脚本(本文件会重新生成,旧的留 .bak)。"
echo "# 生成时间: $(date '+%Y-%m-%d %H:%M:%S')"
echo "# 已启用平台: ${enabled_plats[*]:-(无)}"
echo
if [ "${#enabled_plats[@]}" -eq 0 ]; then
echo "platforms: [] # deploy.conf 里一个平台 key 都没填"
echo "platforms: [] # 没有配置任何平台 key(BIGMODEL_KEY / DEEPSEEK_KEY / QWEN_KEY)"
else
echo "platforms:"
if [ -n "$BIGMODEL_KEY" ]; then emit_platform bigmodel "$BIGMODEL_KEY"; fi
@@ -215,8 +224,8 @@ EOF
else
cat <<'EOF'
# deploy.conf 里没填 ZHIPU_KEY:image-gen / video-gen 先注册但 enable: false(工具不加载)。
# 填上 ZHIPU_KEY 后重跑 init_repos.sh 即启用。
# 没有配置 ZHIPU_KEY:image-gen / video-gen 先注册但 enable: false(工具不加载)。
# 带上 ZHIPU_KEY 重新运行本脚本即启用。
mcp_servers:
- name: web-search
url: "http://mcp_web_search:3000/"
@@ -234,43 +243,52 @@ EOF
fi
} > "$CONFIG_YML"
info "配置来源: $CONFIG_SOURCE"
info "平台: ${enabled_plats[*]:-无};智谱 MCP: $([ -n "$ZHIPU_KEY" ] && echo 启用 || echo 未配置)"
# ============================================================
# 4. 起服务(顺序:agent 先起,它创建 my-app-network)
# 3. 起服务(顺序:agent 先起,它创建 my-app-network)
# ============================================================
log "启动 agent"
docker compose up -d --build
if [ -d "$MCP_DIR" ]; then
log "启动 mcp($MCP_DIR)"
( cd "$MCP_DIR" && docker compose up -d --build )
if [ "$UP" != "1" ]; then
log "UP=$UP:只生成配置,不起服务"
else
warn "没找到 mcp 仓库($MCP_DIR),跳过。"
log "启动 agent"
docker compose up -d --build
if [ -d "$MCP_DIR" ]; then
log "启动 mcp($MCP_DIR)"
( cd "$MCP_DIR" && docker compose up -d --build )
else
warn "没找到 mcp 仓库($MCP_DIR),跳过。可用 MCP_DIR=<路径> 指定。"
fi
fi
# ============================================================
# 5. 汇总
# 4. 汇总
# ============================================================
log "汇总"
echo "---------------------------------------------"
echo " 访问地址 : http://${PUBLIC_IP:-<公网IP>}:${AGENT_PORT}"
echo " 账号 : $AUTH_USER"
echo " 密码 : $AUTH_PASSWORD"
echo " 平台 : ${enabled_plats[*]:-(无,去 /root/deploy.conf 填 key)}"
echo " 平台 : ${enabled_plats[*]:-(无)}"
echo " 智谱 MCP : $([ -n "$ZHIPU_KEY" ] && echo "image-gen / video-gen 已启用" || echo "未配置(enable: false)")"
echo " 日志级别 : $LOG_LEVEL"
echo "---------------------------------------------"
echo
info "容器状态:"
docker compose ps
if [ -d "$MCP_DIR" ]; then
( cd "$MCP_DIR" && docker compose ps )
fi
echo
info "看日志: docker compose logs -f agent-core"
info "自检(期望 400 缺 path 参数,说明签发链路通了):"
info " docker exec mcp_video_gen node -e \"fetch('http://agent-core:8081/public-link').then(async r=>console.log(r.status, await r.text()))\""
info "注意:安全组/防火墙需放行 ${AGENT_PORT}(mcp 三个服务一律不用放行)"
if [ "$UP" = "1" ]; then
echo
info "容器状态:"
docker compose ps
if [ -d "$MCP_DIR" ]; then
( cd "$MCP_DIR" && docker compose ps )
fi
echo
info "看日志: docker compose logs -f agent-core"
if [ -d "$MCP_DIR" ]; then
info "自检(期望 400 缺 path 参数,说明签发链路通了):"
info " docker exec mcp_video_gen node -e \"fetch('http://agent-core:8081/public-link').then(async r=>console.log(r.status, await r.text()))\""
fi
info "注意:安全组/防火墙需放行 ${AGENT_PORT}(mcp 各服务都不映射宿主机端口)"
fi
log "完成 ✅"