diff --git a/README.md b/README.md index f150338..448ef4f 100644 --- a/README.md +++ b/README.md @@ -38,6 +38,8 @@ - 至少一个 OpenAI 兼容模型平台的 API Key。 - 一个可用端口,默认 `8090`。 +Debian 12 裸机可以先跑 `scripts/init_host.sh`(幂等,可重复执行,也可单独拷到服务器上跑):它会配好 Swap、Docker、国内镜像加速与基础 shell 环境;`REGION=oversea` 切海外源。跑完会打印后续的 `init.sh` 与部署步骤。 + ### 1. 生成配置 在仓库根目录执行: diff --git a/scripts/init_host.sh b/scripts/init_host.sh new file mode 100755 index 0000000..6d61f5d --- /dev/null +++ b/scripts/init_host.sh @@ -0,0 +1,383 @@ +#!/bin/bash +# init_host.sh — Debian 12 服务器初始化(国内/海外双区,完全幂等,可重复执行) +# +# 定位:只负责「裸机 → 可运行环境」——bashrc / vimrc / Swap / swappiness / 系统更新 / Docker。 +# 本脚本不 build 任何镜像;镜像由仓库根 `docker compose up -d --build` 在服务器本地构建(见脚本末尾提示)。 +# +# 区域(决定 Docker 用哪个源): +# REGION=cn 国内(默认):腾讯云 docker-ce 镜像源 + registry 加速器 +# REGION=oversea 海外:Docker 官方源,不配加速器 +# +# 用法: +# ./init_host.sh # 国内服务器 +# REGION=oversea ./init_host.sh # 海外服务器 +# SKIP_UPGRADE=1 ./init_host.sh # 跳过 apt upgrade +# DOCKER_SELFTEST=1 ./init_host.sh # 额外跑一次 hello-world 拉取自测(默认关:服务器只 load 镜像) +set -euo pipefail + +# ============================================================ +# 全局配置 +# ============================================================ +BASHRC_MARKER="# ===== init.sh custom config =====" +SWAPFILE="/swapfile" +SWAP_SIZE="2G" +SWAPPINESS_FILE="/etc/sysctl.d/99-swappiness.conf" +SWAPPINESS_VALUE="10" +DOCKER_KEYRING="/etc/apt/keyrings/docker.gpg" +DOCKER_LIST="/etc/apt/sources.list.d/docker.list" +DOCKER_DAEMON_JSON="/etc/docker/daemon.json" + +REGION="${REGION:-cn}" +SKIP_UPGRADE="${SKIP_UPGRADE:-0}" +DOCKER_SELFTEST="${DOCKER_SELFTEST:-0}" +# 末尾提示里用的仓库地址(私有仓库,可改;仅供 git clone 提示,不会被访问) +REPO_URL="${REPO_URL:-https://git.foresh.com/kicer/agent.git}" + +# docker-ce 软件源候选:按顺序试,第一个能下到 GPG key 的胜出 +case "$REGION" in + oversea) + DOCKER_BASES=("https://download.docker.com/linux/debian") + REGISTRY_MIRRORS=() + ;; + *) + DOCKER_BASES=( + "https://mirrors.tencentyun.com/docker-ce/linux/debian" # 腾讯云内网(CVM 首选) + "https://mirrors.cloud.tencent.com/docker-ce/linux/debian" # 腾讯云公网 + ) + REGISTRY_MIRRORS=( + "https://mirror.ccs.tencentyun.com" # 腾讯云内网加速 + "https://docker.1ms.run" + "https://docker.m.daocloud.io" + ) + ;; +esac + +export DEBIAN_FRONTEND=noninteractive + +# ============================================================ +# 日志 +# ============================================================ +log() { echo -e "\n\033[1;32m===== $* =====\033[0m"; } +warn() { echo -e "\033[1;33m[WARN] $*\033[0m"; } +err() { echo -e "\033[1;31m[ERROR] $*\033[0m"; } + +# ============================================================ +# 1. ~/.bashrc +# ============================================================ +setup_bashrc() { + log "1. 配置 ~/.bashrc" + if grep -qF "$BASHRC_MARKER" ~/.bashrc 2>/dev/null; then + echo "已配置,跳过。" + return + fi + cat >> ~/.bashrc << 'EOF' + +# ===== init.sh custom config ===== +export LS_OPTIONS='--color=auto' +eval "$(dircolors)" +alias ls='ls $LS_OPTIONS' +alias ll='ls $LS_OPTIONS -l' +alias l='ls $LS_OPTIONS -lA' + +alias rm='rm -i' +alias cp='cp -i' +alias mv='mv -i' +# ===== init.sh custom config end ===== +EOF + echo "已写入 ~/.bashrc。" +} + +# ============================================================ +# 2. ~/.vimrc +# ============================================================ +setup_vimrc() { + log "2. 配置 ~/.vimrc" + cat > ~/.vimrc << 'EOF' +set number +set smartindent +set autoindent +set shiftwidth=4 +set tabstop=4 +set expandtab +set noswapfile +syntax on +EOF + echo "已写入 ~/.vimrc。" +} + +# ============================================================ +# 3. Swap +# ============================================================ +setup_swap() { + log "3. 配置 ${SWAP_SIZE} Swap" + + if [ -f "$SWAPFILE" ]; then + echo "$SWAPFILE 已存在,跳过创建。" + else + echo "创建 $SWAPFILE(${SWAP_SIZE})..." + local count=$(( ${SWAP_SIZE%G} * 1024 )) + if ! fallocate -l "$SWAP_SIZE" "$SWAPFILE" 2>/dev/null; then + warn "fallocate 失败,改用 dd。" + dd if=/dev/zero of="$SWAPFILE" bs=1M count="$count" status=progress + fi + chmod 600 "$SWAPFILE" + mkswap "$SWAPFILE" + fi + + if swapon --show | grep -q "^$SWAPFILE"; then + echo "Swap 已启用。" + else + swapon "$SWAPFILE" + echo "Swap 已启用。" + fi + + if grep -qF "$SWAPFILE" /etc/fstab; then + echo "/etc/fstab 已包含 Swap 条目。" + else + echo "$SWAPFILE none swap sw 0 0" >> /etc/fstab + echo "已写入 /etc/fstab。" + fi + + free -h + swapon --show +} + +# ============================================================ +# 4. vm.swappiness(独立文件,覆盖写) +# ============================================================ +setup_swappiness() { + log "4. 配置 vm.swappiness=${SWAPPINESS_VALUE}" + + if grep -qE '^[[:space:]]*vm\.swappiness[[:space:]]*=' /etc/sysctl.conf 2>/dev/null; then + warn "检测到 /etc/sysctl.conf 中有 vm.swappiness,注释掉以免重复。" + sed -i -E 's|^[[:space:]]*(vm\.swappiness[[:space:]]*=.*)$|# \1 # moved to '"$SWAPPINESS_FILE"' by init.sh|' /etc/sysctl.conf + fi + + echo "vm.swappiness=${SWAPPINESS_VALUE}" > "$SWAPPINESS_FILE" + sysctl --system >/dev/null 2>&1 || true + echo "当前值: $(cat /proc/sys/vm/swappiness)" +} + +# ============================================================ +# 5. 系统包更新(幂等;可用 SKIP_UPGRADE=1 跳过) +# ============================================================ +setup_system_update() { + log "5. 系统包更新" + + if [ "$SKIP_UPGRADE" = "1" ]; then + echo "SKIP_UPGRADE=1,跳过。" + return + fi + + echo "--- apt update ---" + apt update + + echo "--- apt upgrade(非交互,保留旧配置文件)---" + apt upgrade -y \ + -o Dpkg::Options::="--force-confdef" \ + -o Dpkg::Options::="--force-confold" + + # autoremove:无残留时 apt 会输出 0 行,天然幂等 + echo "--- apt autoremove ---" + apt autoremove -y + + # 清理已下载的 .deb 缓存(幂等) + apt clean + + # 是否需要重启 + if [ -f /var/run/reboot-required ]; then + warn "系统建议重启以应用内核/核心库更新。" + warn "请手动执行: reboot" + [ -f /var/run/reboot-required.pkgs ] && \ + warn "相关包: $(tr '\n' ' ' < /var/run/reboot-required.pkgs)" + else + echo "无需重启。" + fi +} + +# ============================================================ +# 6. Docker 安装(已装并运行则整体跳过;源随 REGION 走) +# ============================================================ +setup_docker() { + log "6. 安装 Docker(REGION=$REGION)" + + # 已安装且运行中 → 跳过:不覆盖仓库文件、不下载 GPG key、不碰已有配置 + if command -v docker >/dev/null 2>&1 && systemctl is-active --quiet docker; then + echo "Docker 已安装并运行,跳过。" + return + fi + + # 6.1 HTTPS 相关工具(已装则跳过) + if ! dpkg -s ca-certificates curl gnupg >/dev/null 2>&1; then + apt update + apt install -y ca-certificates curl gnupg + fi + + install -m 0755 -d /etc/apt/keyrings + + # 6.2 GPG key + 选定可用源 + local base="" + if [ -s "$DOCKER_KEYRING" ] && gpg --show-keys "$DOCKER_KEYRING" >/dev/null 2>&1; then + echo "Docker GPG key 已存在且有效,跳过下载。" + # 复用上次写进 docker.list 的源(第 1 列 deb,第 3 列是 URL) + base="$(awk '$1 == "deb" { print $3; exit }' "$DOCKER_LIST" 2>/dev/null || true)" + [ -n "$base" ] || base="${DOCKER_BASES[0]}" + else + local cand + for cand in "${DOCKER_BASES[@]}"; do + echo "下载 Docker GPG key:$cand/gpg" + rm -f "$DOCKER_KEYRING" + if curl -fsSL --retry 3 --retry-delay 2 --connect-timeout 10 \ + "$cand/gpg" \ + | gpg --dearmor --yes -o "$DOCKER_KEYRING" 2>/dev/null \ + && [ -s "$DOCKER_KEYRING" ]; then + base="$cand" + break + fi + warn "该源不可用,尝试下一个。" + done + if [ -z "$base" ]; then + err "所有 Docker 源都下不到 GPG key。检查网络,或换 REGION=oversea / 手动改 DOCKER_BASES。" + exit 1 + fi + chmod a+r "$DOCKER_KEYRING" + echo "GPG key 已就位(源:$base)。" + fi + + # 6.3 仓库覆盖写 + local codename arch + codename=$(. /etc/os-release && echo "$VERSION_CODENAME") + arch=$(dpkg --print-architecture) + echo "deb [arch=$arch signed-by=$DOCKER_KEYRING] $base $codename stable" \ + > "$DOCKER_LIST" + + # 6.4 安装 + apt update + apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin + systemctl enable --now docker + echo "Docker 已安装并启用。" +} + +# ============================================================ +# 7. Docker 镜像加速器(仅国内;已有 registry-mirrors 则不动) +# ============================================================ +setup_docker_mirrors() { + log "7. 配置 Docker 镜像加速器" + + if [ "${#REGISTRY_MIRRORS[@]}" -eq 0 ]; then + echo "REGION=$REGION 不需要加速器,跳过。" + return + fi + + mkdir -p /etc/docker + + if [ -f "$DOCKER_DAEMON_JSON" ]; then + if grep -q '"registry-mirrors"' "$DOCKER_DAEMON_JSON"; then + echo "$DOCKER_DAEMON_JSON 已包含 registry-mirrors,跳过。" + return + fi + local bak="${DOCKER_DAEMON_JSON}.bak.$(date +%s)" + warn "$DOCKER_DAEMON_JSON 已存在但无 registry-mirrors,备份到 $bak 后覆盖。" + cp "$DOCKER_DAEMON_JSON" "$bak" + fi + + { + echo '{' + echo ' "registry-mirrors": [' + local last=$(( ${#REGISTRY_MIRRORS[@]} - 1 )) + local i comma + for i in "${!REGISTRY_MIRRORS[@]}"; do + comma="," + [ "$i" -eq "$last" ] && comma="" + printf ' "%s"%s\n' "${REGISTRY_MIRRORS[$i]}" "$comma" + done + echo ' ]' + echo '}' + } > "$DOCKER_DAEMON_JSON" + + echo "已写入 $DOCKER_DAEMON_JSON" + systemctl daemon-reload + systemctl restart docker + echo "Docker 已重启(已 load 的镜像不受影响)。" +} + +# ============================================================ +# 8. 验证 +# ============================================================ +verify() { + log "8. 验证" + docker --version + echo + echo "--- Registry Mirrors ---" + docker info 2>/dev/null | grep -A6 "Registry Mirrors" || true + + if [ "$DOCKER_SELFTEST" = "1" ]; then + echo + echo "--- hello-world 自测(DOCKER_SELFTEST=1)---" + if docker run --rm hello-world; then + echo "Docker 拉取自测通过。" + else + warn "hello-world 拉取失败,请检查网络或镜像源。" + fi + fi +} + +# ============================================================ +# 9. 后续部署提示(只打印,不执行任何部署动作) +# ============================================================ +print_next_steps() { + local repo_dir="" + repo_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." 2>/dev/null && pwd || true)" + + log "部署下一步" + + # 脚本就在本仓库的 scripts/ 下 → 直接给 cd;否则按「单独拷出来跑」给 clone。 + # 判据不用「父目录里有没有 docker-compose.yml」:目录里可能恰好存着一份别处的配置(/tmp 就踩过), + # 要求 docker-compose.yml 与 scripts/init.sh 同时存在,才算真仓库根。 + if [ -n "$repo_dir" ] && [ -f "$repo_dir/docker-compose.yml" ] && [ -f "$repo_dir/scripts/init.sh" ]; then + echo "① 进入仓库" + echo " cd $repo_dir" + else + echo "① 拉代码(私有仓库,需先配好 git 凭据)" + echo " git clone $REPO_URL ~/agent" + echo " cd ~/agent" + fi + + cat <<'EOF' + +② 生成配置(三个 Key 都可选,填几个启用几个;PUBLIC_IP 不填会自动探测) + BIGMODEL_KEY=xxx DEEPSEEK_KEY=yyy QWEN_KEY=zzz \ + AUTH_USER=admin AUTH_PASSWORD='换成强密码' PUBLIC_IP=<公网IP> \ + ./scripts/init.sh + +③ 构建并启动(首次会构建 MCP 镜像 + executor 技能层,耗时较久) + docker compose up -d --build + docker compose logs -f agent-core # 出现 "Agent server listening on 8090" 即就绪 + +④ 腾讯云控制台 → 安全组:放行 TCP 8090 入站(改过 AGENT_PORT 就放行对应端口) +⑤ 浏览器打开 http://<公网IP>:8090,用 init.sh 打印的账号登录 + +备注: +- 上面若提示需要重启(内核/核心库更新),建议先 reboot,再执行第 ③ 步 +- init.sh 可重复执行:.env 里的密钥复用,config.yml 会先备份为 .bak.<时间戳> +- 只刷新密钥、不动配置:./scripts/init.sh --env-only +EOF +} + +# ============================================================ +# main +# ============================================================ +main() { + setup_bashrc + setup_vimrc + setup_swap + setup_swappiness + setup_system_update + setup_docker + setup_docker_mirrors + verify + log "初始化完成 ✅" + print_next_steps +} + +main "$@"