新增 Debian 裸机初始化脚本,并在结束时打印部署步骤
This commit is contained in:
@@ -38,6 +38,8 @@
|
||||
- 至少一个 OpenAI 兼容模型平台的 API Key。
|
||||
- 一个可用端口,默认 `8090`。
|
||||
|
||||
Debian 12 裸机可以先跑 `scripts/init_host.sh`(幂等,可重复执行,也可单独拷到服务器上跑):它会配好 Swap、Docker、国内镜像加速与基础 shell 环境;`REGION=oversea` 切海外源。跑完会打印后续的 `init.sh` 与部署步骤。
|
||||
|
||||
### 1. 生成配置
|
||||
|
||||
在仓库根目录执行:
|
||||
|
||||
Executable
+383
@@ -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 "$@"
|
||||
Reference in New Issue
Block a user