From 40fb85464db05327fa4c2dafcca61932fda6eadc Mon Sep 17 00:00:00 2001 From: kicer Date: Tue, 15 Sep 2026 20:35:29 +0800 Subject: [PATCH] =?UTF-8?q?=E9=83=A8=E7=BD=B2=EF=BC=9Ascripts/init.sh=20?= =?UTF-8?q?=E6=94=B9=E4=B8=BA=E7=BA=AF=E7=8E=AF=E5=A2=83=E5=8F=98=E9=87=8F?= =?UTF-8?q?=E9=A9=B1=E5=8A=A8=EF=BC=8C=E9=9B=B6=E5=8F=82=E6=95=B0=E5=8F=AF?= =?UTF-8?q?=E7=9B=B4=E6=8E=A5=E8=BF=90=E8=A1=8C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 不再依赖任何外部文件;全变量可选,什么都不给也能生成并启动(admin/admin、自动探测公网 IP、platforms: []) - 新增 UP=0(只生成 .env/config.yml,不起容器;此时不检查 docker,没装 Docker 的机器也能用) - 环境变量优先,MCP_DIR 不存在则跳过并提示 - 输出与生成物里的措辞去掉 /root 路径硬编码(保持中性) - docs/DEPLOY.md 第 0 节改写为「只读环境变量」的用法 --- docs/DEPLOY.md | 28 +++++++---- scripts/init.sh | 124 +++++++++++++++++++++++++++--------------------- 2 files changed, 91 insertions(+), 61 deletions(-) diff --git a/docs/DEPLOY.md b/docs/DEPLOY.md index 71ed6cf..4307341 100644 --- a/docs/DEPLOY.md +++ b/docs/DEPLOY.md @@ -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. 网络(自动创建,无需手动) diff --git a/scripts/init.sh b/scripts/init.sh index 18a1fe2..be47900 100755 --- a/scripts/init.sh +++ b/scripts/init.sh @@ -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" </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 "完成 ✅"