feat: add GitHub Actions release workflow and one-line install script
This commit is contained in:
kory
@@ -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 服务端部署
|
### 1. Hub 服务端部署
|
||||||
|
|
||||||
|
|||||||
Executable
+207
@@ -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
|
||||||
Reference in New Issue
Block a user