feat: add GitHub Actions release workflow and one-line install script

2026-09-28 08:02:05 +08:00
parent ac3c8377de
commit c91389874a
3 changed files with 266 additions and 1 deletions
@@ -0,0 +1,45 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+
+jobs:
+  build:
+    name: Build & Release
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: '1.22'
+
+      - name: Build Hub & Agent
+        run: |
+          mkdir -p dist
+          # Linux AMD64
+          CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -trimpath -ldflags "-s -w" -o dist/vps-commander-hub-linux-amd64 ./cmd/hub
+          CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -trimpath -ldflags "-s -w" -o dist/vps-commander-agent-linux-amd64 ./cmd/agent
+          
+          # Linux ARM64
+          CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -trimpath -ldflags "-s -w" -o dist/vps-commander-hub-linux-arm64 ./cmd/hub
+          CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -trimpath -ldflags "-s -w" -o dist/vps-commander-agent-linux-arm64 ./cmd/agent
+
+          # Checksums
+          cd dist
+          sha256sum * > checksums.txt
+          cd ..
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: |
+            dist/*
+          generate_release_notes: true
@@ -65,7 +65,20 @@

 ---

-## 🚀 快速上手与部署
+## 🚀 极速一键部署 (推荐)
+
+无论是在受控端 VPS 还是中心端，只需一行命令即可交互式安装与启动：
+
+```bash
+bash <(curl -sSL https://raw.githubusercontent.com/kyaring/vps-commander/main/deploy/install.sh)
+```
+
+- **安装 Agent (受控 VPS)**：输入 Hub 的 WSS 地址与通信密钥，全自动配置开机自启并秒级连入集群。
+- **安装 Hub (中心服务端)**：自动生成安全 API Key / Web 面板密码并以 Systemd 托管常驻。
+
+---
+
+## 🛠️ 手动编译部署

 ### 1. Hub 服务端部署

@@ -0,0 +1,207 @@
+#!/bin/bash
+set -e
+
+# VPS-Commander 一键安装与配置脚本 (Hub / Agent)
+# Repo: https://github.com/kyaring/vps-commander
+
+REPO="kyaring/vps-commander"
+INSTALL_DIR="/opt/vps-commander"
+CONF_DIR="/etc/vps-commander"
+GITHUB_URL="https://github.com"
+
+# 颜色输出
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+info() { echo -e "${BLUE}[INFO]${NC} $*"; }
+success() { echo -e "${GREEN}[SUCCESS]${NC} $*"; }
+warn() { echo -e "${YELLOW}[WARN]${NC} $*"; }
+error() { echo -e "${RED}[ERROR]${NC} $*"; exit 1; }
+
+# 检查 root 权限
+[[ $EUID -ne 0 ]] && error "必须使用 root 权限运行此脚本 (例如: sudo bash install.sh)"
+
+# 架构检测
+ARCH=$(uname -m)
+case "$ARCH" in
+    x86_64|amd64) TARGET_ARCH="amd64" ;;
+    aarch64|arm64) TARGET_ARCH="arm64" ;;
+    *) error "暂不支持的系统架构: $ARCH (仅支持 x86_64/amd64 与 aarch64/arm64)" ;;
+esac
+
+# 检查基础依赖
+command -v curl >/dev/null 2>&1 || (apt-get update && apt-get install -y curl || yum install -y curl)
+
+# 获取最新版本 tag
+info "正在获取 VPS-Commander 最新版本信息..."
+LATEST_TAG=$(curl -sSL "https://api.github.com/repos/${REPO}/releases/latest" | grep '"tag_name":' | sed -E 's/.*"([^"]+)".*/\1/')
+if [ -z "$LATEST_TAG" ]; then
+    warn "无法通过 GitHub API 自动获取 Tag，将尝试使用默认版本 v1.0.0"
+    LATEST_TAG="v1.0.0"
+fi
+info "检测到最新版本: ${LATEST_TAG}"
+
+mkdir -p "$INSTALL_DIR" "$INSTALL_DIR/data" "$CONF_DIR"
+chmod 750 "$INSTALL_DIR" "$CONF_DIR"
+
+select_mode() {
+    echo -e "\n请选择安装模式:"
+    echo "1) 安装受控端 Agent (推荐：在受控 VPS 上一键连入集群)"
+    echo "2) 安装中心端 Hub (管理中心)"
+    read -rp "请输入选项 [1-2] (默认 1): " MODE
+    MODE=${MODE:-1}
+}
+
+install_agent() {
+    info "开始安装 VPS-Commander Agent (${TARGET_ARCH})..."
+    BIN_NAME="vps-commander-agent-linux-${TARGET_ARCH}"
+    DOWNLOAD_URL="${GITHUB_URL}/${REPO}/releases/download/${LATEST_TAG}/${BIN_NAME}"
+
+    info "正在下载 Agent: ${DOWNLOAD_URL}"
+    curl -sSL -o "${INSTALL_DIR}/vps-commander-agent" "${DOWNLOAD_URL}" || error "下载失败，请检查网络或 Release 是否存在"
+    chmod +x "${INSTALL_DIR}/vps-commander-agent"
+
+    echo -e "\n--- 配置 Agent 参数 ---"
+    read -rp "请输入 Hub WSS 连接地址 (默认: wss://vpstool.kory.kdns.fr/agent/ws): " HUB_WS
+    HUB_WS=${HUB_WS:-"wss://vpstool.kory.kdns.fr/agent/ws"}
+
+    DEFAULT_NAME=$(hostname)
+    read -rp "请输入本节点名称 (默认: ${DEFAULT_NAME}): " AGENT_NAME
+    AGENT_NAME=${AGENT_NAME:-${DEFAULT_NAME}}
+
+    read -rp "请输入 Cluster Secret (集群通信密钥): " CLUSTER_SECRET
+    while [ -z "$CLUSTER_SECRET" ]; do
+        read -rp "Cluster Secret 不能为空，请重新输入: " CLUSTER_SECRET
+    done
+
+    # 写入凭据文件
+    cat << ENV > "${CONF_DIR}/agent.env"
+VPS_COMMANDER_HUB_WS_URL=${HUB_WS}
+VPS_COMMANDER_AGENT_NAME=${AGENT_NAME}
+VPS_COMMANDER_CLUSTER_SECRET=${CLUSTER_SECRET}
+ENV
+    chmod 0600 "${CONF_DIR}/agent.env"
+
+    # 配置 systemd
+    cat << SVC > /etc/systemd/system/vps-commander-agent.service
+[Unit]
+Description=VPS-Commander Agent
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+Type=simple
+User=root
+WorkingDirectory=${INSTALL_DIR}
+EnvironmentFile=-${CONF_DIR}/agent.env
+ExecStart=${INSTALL_DIR}/vps-commander-agent -hub \${VPS_COMMANDER_HUB_WS_URL} -name \${VPS_COMMANDER_AGENT_NAME}
+Restart=always
+RestartSec=3s
+KillSignal=SIGTERM
+TimeoutStopSec=10s
+LimitNOFILE=65536
+Environment=GOGC=50
+
+[Install]
+WantedBy=multi-user.target
+SVC
+
+    systemctl daemon-reload
+    systemctl enable --now vps-commander-agent
+    sleep 1
+
+    if systemctl is-active --quiet vps-commander-agent; then
+        success "VPS-Commander Agent 安装并启动成功！"
+        info "节点名称: ${AGENT_NAME}"
+        info "可通过 'systemctl status vps-commander-agent' 查看运行状态。"
+    else
+        warn "服务已启动但状态可能异常，请检查 'journalctl -u vps-commander-agent -n 20'。"
+    fi
+}
+
+install_hub() {
+    info "开始安装 VPS-Commander Hub (${TARGET_ARCH})..."
+    BIN_NAME="vps-commander-hub-linux-${TARGET_ARCH}"
+    DOWNLOAD_URL="${GITHUB_URL}/${REPO}/releases/download/${LATEST_TAG}/${BIN_NAME}"
+
+    info "正在下载 Hub: ${DOWNLOAD_URL}"
+    curl -sSL -o "${INSTALL_DIR}/vps-commander-hub" "${DOWNLOAD_URL}" || error "下载失败，请检查网络或 Release 是否存在"
+    chmod +x "${INSTALL_DIR}/vps-commander-hub"
+
+    echo -e "\n--- 配置 Hub 参数 ---"
+    read -rp "请输入监听端口 (默认 9521): " HUB_PORT
+    HUB_PORT=${HUB_PORT:-9521}
+
+    # 自动生成随机凭据
+    GEN_API_KEY=$(head -c 24 /dev/urandom | xxd -p)
+    GEN_SECRET=$(head -c 24 /dev/urandom | xxd -p)
+    GEN_PASS=$(head -c 16 /dev/urandom | xxd -p)
+
+    read -rp "请输入 API Key (默认随机生成): " API_KEY
+    API_KEY=${API_KEY:-$GEN_API_KEY}
+
+    read -rp "请输入 Cluster Secret (默认随机生成): " CLUSTER_SECRET
+    CLUSTER_SECRET=${CLUSTER_SECRET:-$GEN_SECRET}
+
+    read -rp "请输入 Web 管理面板密码 (默认随机生成): " WEB_PASS
+    WEB_PASS=${WEB_PASS:-$GEN_PASS}
+
+    cat << ENV > "${CONF_DIR}/hub.env"
+VPS_COMMANDER_API_KEY=${API_KEY}
+VPS_COMMANDER_CLUSTER_SECRET=${CLUSTER_SECRET}
+VPS_COMMANDER_WEB_PASSWORD=${WEB_PASS}
+ENV
+    chmod 0600 "${CONF_DIR}/hub.env"
+
+    cat << SVC > /etc/systemd/system/vps-commander-hub.service
+[Unit]
+Description=VPS-Commander Hub
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+Type=simple
+User=root
+WorkingDirectory=${INSTALL_DIR}
+EnvironmentFile=-${CONF_DIR}/hub.env
+ExecStart=${INSTALL_DIR}/vps-commander-hub -addr 127.0.0.1:${HUB_PORT} -db ${INSTALL_DIR}/data/commander.db
+Restart=always
+RestartSec=3s
+KillSignal=SIGTERM
+TimeoutStopSec=10s
+LimitNOFILE=65536
+Environment=GOGC=50
+
+[Install]
+WantedBy=multi-user.target
+SVC
+
+    systemctl daemon-reload
+    systemctl enable --now vps-commander-hub
+    sleep 1
+
+    if systemctl is-active --quiet vps-commander-hub; then
+        success "VPS-Commander Hub 安装并启动成功！"
+        echo -e "\n================== Hub 配置凭据 =================="
+        echo -e "监听地址: 127.0.0.1:${HUB_PORT}"
+        echo -e "API Key: ${API_KEY}"
+        echo -e "Cluster Secret: ${CLUSTER_SECRET}"
+        echo -e "Web 面板密码: ${WEB_PASS}"
+        echo -e "==================================================\n"
+        warn "请妥善保管上述凭据，反代请将域名反代至 127.0.0.1:${HUB_PORT}"
+    else
+        warn "服务已启动但状态可能异常，请检查 'journalctl -u vps-commander-hub -n 20'。"
+    fi
+}
+
+select_mode
+if [ "$MODE" = "1" ]; then
+    install_agent
+elif [ "$MODE" = "2" ]; then
+    install_hub
+else
+    error "无效选项"
+fi