Logan.Li
4ae318335c
基于 opsx-web-lite 框架（Go+Gin+Vue3+Element Plus）构建许可证管理服务器，
业务域参考 Licence 服务器 Web 版。
【后端 - 4层架构】
- 认证：单 Admin 表 + JWT（HS256）
- 核心授权域：Product / Customer / License / Activation
· License 生成/验证/激活/机器绑定/心跳/续期/吊销
· 客户端契约接口：/api/v1/license/{verify,activate,deactivate,heartbeat}
- 定价订单：Plan / Order / 支付网关配置
- 防重复购买：CustomerEntitlement + 幂等支付 webhook + 手动发放
- 分析审计：Dashboard 统计 / Analytics / AuditLog / Setting 管理
【前端】
- Dashboard（ECharts 图表）、产品、客户、License、计划、订单、权益、日志、设置
- 9 个完整 CRUD 业务页面 + 登录/布局
【部署】
- SQLite + 单二进制（//go:embed 嵌入前端）
- 开发：./run.sh start（前端5181/后端9001）
- 生产：./run.sh build && ./run.sh binary start
- 默认账号：admin/admin
Author: Logan.Li
407 lines
12 KiB
Bash
Executable File
407 lines
12 KiB
Bash
Executable File
#!/bin/bash
|
||
# opsx-licence 启动脚本
|
||
# 一键启动前后端服务，支持日志轮转与单二进制部署
|
||
# 用法: ./run.sh [start|stop|restart|status|frontend|backend|build|binary|help]
|
||
|
||
set -e
|
||
|
||
# ============================================================
|
||
# 配置区
|
||
# ============================================================
|
||
PROJECT_NAME="opsx-licence"
|
||
BACKEND_PORT=9001
|
||
FRONTEND_PORT=5181
|
||
BACKEND_DIR="backend"
|
||
FRONTEND_DIR="frontend"
|
||
BACKEND_BIN="backend"
|
||
STANDALONE_BIN="opsx-licence"
|
||
STANDALONE_PORT="${PORT:-9001}"
|
||
BACKEND_LAUNCH_LABEL="com.opsx.licence.backend"
|
||
FRONTEND_LAUNCH_LABEL="com.opsx.licence.frontend"
|
||
|
||
# 日志配置
|
||
MAX_LOG_FILES=3
|
||
MAX_LOG_SIZE=$((50 * 1024 * 1024)) # 50MB
|
||
|
||
# ============================================================
|
||
# 通用函数
|
||
# ============================================================
|
||
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} $1"; }
|
||
success() { echo -e "${GREEN}[SUCCESS]${NC} $1"; }
|
||
warning() { echo -e "${YELLOW}[WARNING]${NC} $1"; }
|
||
error() { echo -e "${RED}[ERROR]${NC} $1"; }
|
||
|
||
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||
cd "$SCRIPT_DIR"
|
||
|
||
# PID 文件
|
||
BACKEND_PID_FILE="$SCRIPT_DIR/$BACKEND_DIR/.backend.pid"
|
||
FRONTEND_PID_FILE="$SCRIPT_DIR/$FRONTEND_DIR/.frontend.pid"
|
||
STANDALONE_PID_FILE="$SCRIPT_DIR/.opsx-licence.pid"
|
||
STANDALONE_LOG_FILE="$SCRIPT_DIR/logs/opsx-licence.log"
|
||
|
||
# 检查端口是否被占用
|
||
check_port() {
|
||
lsof -ti:$1 2>/dev/null | head -1
|
||
}
|
||
|
||
# 释放端口
|
||
kill_port() {
|
||
local pids=$(lsof -ti:$1 2>/dev/null || echo "")
|
||
if [ -n "$pids" ]; then
|
||
info "释放端口 $1..."
|
||
echo "$pids" | xargs kill -9 2>/dev/null || true
|
||
sleep 1
|
||
fi
|
||
}
|
||
|
||
# 日志轮转（仅启动时调用）
|
||
rotate_log() {
|
||
local log_file=$1
|
||
[ ! -f "$log_file" ] && return 0
|
||
|
||
local file_size=$(stat -f%z "$log_file" 2>/dev/null || stat -c%s "$log_file" 2>/dev/null || echo "0")
|
||
if [ "$file_size" -gt "$MAX_LOG_SIZE" ]; then
|
||
[ -f "${log_file}.${MAX_LOG_FILES}" ] && rm -f "${log_file}.${MAX_LOG_FILES}"
|
||
for i in $(seq $((MAX_LOG_FILES - 1)) -1 1); do
|
||
[ -f "${log_file}.${i}" ] && mv "${log_file}.${i}" "${log_file}.$((i + 1))"
|
||
done
|
||
mv "$log_file" "${log_file}.1"
|
||
info "日志已轮转: $log_file"
|
||
fi
|
||
}
|
||
|
||
# macOS 使用 launchctl 脱离当前终端，避免开发服务在脚本退出后被系统回收。 // Logan.Li
|
||
start_detached() {
|
||
local label="$1"
|
||
local log_file="$2"
|
||
local command="$3"
|
||
|
||
if [ "$(uname -s)" = "Darwin" ] && command -v launchctl >/dev/null 2>&1; then
|
||
launchctl remove "$label" 2>/dev/null || true
|
||
launchctl submit -l "$label" -o "$log_file" -e "$log_file" -- /bin/sh -c "$command"
|
||
else
|
||
nohup /bin/sh -c "$command" >> "$log_file" 2>&1 < /dev/null &
|
||
echo $!
|
||
fi
|
||
}
|
||
|
||
# macOS 下卸载 launchctl 任务，其他系统沿用 PID 与端口清理。 // Logan.Li
|
||
stop_detached() {
|
||
local label="$1"
|
||
if [ "$(uname -s)" = "Darwin" ] && command -v launchctl >/dev/null 2>&1; then
|
||
launchctl remove "$label" 2>/dev/null || true
|
||
fi
|
||
}
|
||
|
||
# ============================================================
|
||
# 后端服务
|
||
# ============================================================
|
||
start_backend() {
|
||
info "正在启动后端服务..."
|
||
cd "$SCRIPT_DIR/$BACKEND_DIR"
|
||
mkdir -p logs
|
||
rotate_log "logs/server.log"
|
||
|
||
# 释放被占用的端口
|
||
kill_port $BACKEND_PORT
|
||
|
||
export PORT=$BACKEND_PORT
|
||
export GIN_MODE=debug
|
||
|
||
# 编译并运行
|
||
info "编译 Go 程序..."
|
||
go build -o "$BACKEND_BIN" .
|
||
|
||
start_detached "$BACKEND_LAUNCH_LABEL" "$SCRIPT_DIR/$BACKEND_DIR/logs/server.log" \
|
||
"cd \"$SCRIPT_DIR/$BACKEND_DIR\" && exec env PORT=\"$BACKEND_PORT\" GIN_MODE=\"debug\" ./\"$BACKEND_BIN\""
|
||
|
||
# 等待服务启动
|
||
local retries=0
|
||
while ! curl -s "http://localhost:$BACKEND_PORT/health" > /dev/null 2>&1; do
|
||
retries=$((retries + 1))
|
||
if [ $retries -ge 30 ]; then
|
||
error "后端服务启动超时，请检查日志: $BACKEND_DIR/logs/server.log"
|
||
return 1
|
||
fi
|
||
sleep 1
|
||
done
|
||
|
||
echo "$(check_port $BACKEND_PORT)" > "$BACKEND_PID_FILE"
|
||
|
||
success "后端服务已启动 (PID: $(cat "$BACKEND_PID_FILE"), 端口: $BACKEND_PORT)"
|
||
return 0
|
||
}
|
||
|
||
stop_backend() {
|
||
stop_detached "$BACKEND_LAUNCH_LABEL"
|
||
if [ -f "$BACKEND_PID_FILE" ]; then
|
||
local pid=$(cat "$BACKEND_PID_FILE" 2>/dev/null || echo "")
|
||
if [ -n "$pid" ] && kill -0 "$pid" 2>/dev/null; then
|
||
kill "$pid" 2>/dev/null || true
|
||
success "后端服务已停止"
|
||
fi
|
||
rm -f "$BACKEND_PID_FILE"
|
||
fi
|
||
kill_port $BACKEND_PORT
|
||
}
|
||
|
||
# ============================================================
|
||
# 前端服务
|
||
# ============================================================
|
||
start_frontend() {
|
||
info "正在启动前端服务..."
|
||
cd "$SCRIPT_DIR/$FRONTEND_DIR"
|
||
mkdir -p logs
|
||
rotate_log "logs/dev.log"
|
||
|
||
kill_port $FRONTEND_PORT
|
||
|
||
if [ ! -d "node_modules" ]; then
|
||
warning "node_modules 不存在，正在安装依赖..."
|
||
npm install
|
||
fi
|
||
|
||
local npm_bin
|
||
npm_bin=$(command -v npm)
|
||
start_detached "$FRONTEND_LAUNCH_LABEL" "$SCRIPT_DIR/$FRONTEND_DIR/logs/dev.log" \
|
||
"cd \"$SCRIPT_DIR/$FRONTEND_DIR\" && exec env PATH=\"$PATH\" \"$npm_bin\" run dev"
|
||
|
||
# 等待服务启动
|
||
local retries=0
|
||
while ! curl -s "http://localhost:$FRONTEND_PORT" > /dev/null 2>&1; do
|
||
retries=$((retries + 1))
|
||
if [ $retries -ge 30 ]; then
|
||
error "前端服务启动超时，请检查日志: $FRONTEND_DIR/logs/dev.log"
|
||
return 1
|
||
fi
|
||
sleep 1
|
||
done
|
||
|
||
echo "$(check_port $FRONTEND_PORT)" > "$FRONTEND_PID_FILE"
|
||
|
||
success "前端服务已启动 (PID: $(cat "$FRONTEND_PID_FILE"), 端口: $FRONTEND_PORT)"
|
||
info "前端地址: http://localhost:$FRONTEND_PORT"
|
||
return 0
|
||
}
|
||
|
||
stop_frontend() {
|
||
stop_detached "$FRONTEND_LAUNCH_LABEL"
|
||
if [ -f "$FRONTEND_PID_FILE" ]; then
|
||
local pid=$(cat "$FRONTEND_PID_FILE" 2>/dev/null || echo "")
|
||
if [ -n "$pid" ] && kill -0 "$pid" 2>/dev/null; then
|
||
kill "$pid" 2>/dev/null || true
|
||
success "前端服务已停止"
|
||
fi
|
||
rm -f "$FRONTEND_PID_FILE"
|
||
fi
|
||
kill_port $FRONTEND_PORT
|
||
}
|
||
|
||
# ============================================================
|
||
# 单二进制部署模式
|
||
# ============================================================
|
||
build_binary() {
|
||
info "构建前端生产资源..."
|
||
cd "$SCRIPT_DIR/$FRONTEND_DIR"
|
||
npm run build
|
||
|
||
info "嵌入前端资源并编译 $STANDALONE_BIN..."
|
||
rm -rf "$SCRIPT_DIR/$BACKEND_DIR/static"
|
||
mkdir -p "$SCRIPT_DIR/$BACKEND_DIR/static"
|
||
cp -R dist/. "$SCRIPT_DIR/$BACKEND_DIR/static/"
|
||
|
||
cd "$SCRIPT_DIR/$BACKEND_DIR"
|
||
CGO_ENABLED=1 go build -trimpath -ldflags="-s -w" -o "$SCRIPT_DIR/$STANDALONE_BIN" .
|
||
success "单二进制已生成: $SCRIPT_DIR/$STANDALONE_BIN"
|
||
}
|
||
|
||
start_binary() {
|
||
if [ ! -x "$SCRIPT_DIR/$STANDALONE_BIN" ]; then
|
||
error "未找到 $STANDALONE_BIN，请先执行 ./run.sh build"
|
||
return 1
|
||
fi
|
||
|
||
mkdir -p "$SCRIPT_DIR/logs"
|
||
rotate_log "$STANDALONE_LOG_FILE"
|
||
kill_port "$STANDALONE_PORT"
|
||
|
||
info "启动单二进制服务..."
|
||
PORT="$STANDALONE_PORT" GIN_MODE="${GIN_MODE:-debug}" nohup "$SCRIPT_DIR/$STANDALONE_BIN" >> "$STANDALONE_LOG_FILE" 2>&1 &
|
||
echo $! > "$STANDALONE_PID_FILE"
|
||
|
||
local retries=0
|
||
while ! curl -s "http://localhost:$STANDALONE_PORT/health" > /dev/null 2>&1; do
|
||
retries=$((retries + 1))
|
||
if [ $retries -ge 30 ]; then
|
||
error "单二进制启动超时，请检查日志: $STANDALONE_LOG_FILE"
|
||
return 1
|
||
fi
|
||
sleep 1
|
||
done
|
||
success "单二进制服务已启动: http://localhost:$STANDALONE_PORT (PID: $(cat "$STANDALONE_PID_FILE"))"
|
||
}
|
||
|
||
stop_binary() {
|
||
if [ -f "$STANDALONE_PID_FILE" ]; then
|
||
local pid=$(cat "$STANDALONE_PID_FILE" 2>/dev/null || echo "")
|
||
if [ -n "$pid" ] && kill -0 "$pid" 2>/dev/null; then
|
||
kill "$pid" 2>/dev/null || true
|
||
fi
|
||
rm -f "$STANDALONE_PID_FILE"
|
||
fi
|
||
kill_port "$STANDALONE_PORT"
|
||
}
|
||
|
||
binary_status() {
|
||
if [ -n "$(check_port $STANDALONE_PORT)" ]; then
|
||
success "单二进制服务: 运行中 (端口 $STANDALONE_PORT)"
|
||
else
|
||
warning "单二进制服务: 未运行"
|
||
fi
|
||
}
|
||
|
||
binary_command() {
|
||
case "${1:-start}" in
|
||
start) start_binary ;;
|
||
stop) stop_binary ;;
|
||
restart) stop_binary; sleep 1; start_binary ;;
|
||
status) binary_status ;;
|
||
upgrade) stop_binary; build_binary; start_binary ;;
|
||
*)
|
||
error "未知 binary 命令: $1"
|
||
echo "用法: ./run.sh binary [start|stop|restart|status|upgrade]"
|
||
return 1
|
||
;;
|
||
esac
|
||
}
|
||
|
||
# ============================================================
|
||
# 命令
|
||
# ============================================================
|
||
stop() {
|
||
info "正在停止服务..."
|
||
stop_backend
|
||
stop_frontend
|
||
info "所有服务已停止"
|
||
}
|
||
|
||
show_status() {
|
||
info "服务状态:"
|
||
if [ -n "$(check_port $BACKEND_PORT)" ]; then
|
||
success "后端服务: 运行中 (PID: $(check_port $BACKEND_PORT), 端口: $BACKEND_PORT)"
|
||
else
|
||
warning "后端服务: 未运行"
|
||
fi
|
||
|
||
if [ -n "$(check_port $FRONTEND_PORT)" ]; then
|
||
success "前端服务: 运行中 (端口: $FRONTEND_PORT)"
|
||
else
|
||
warning "前端服务: 未运行"
|
||
fi
|
||
}
|
||
|
||
show_help() {
|
||
echo "$PROJECT_NAME 启动脚本"
|
||
echo ""
|
||
echo "用法: ./run.sh [命令]"
|
||
echo ""
|
||
echo "命令:"
|
||
echo " start 启动前后端服务 (默认)"
|
||
echo " stop 停止前后端服务"
|
||
echo " restart 重启前后端服务"
|
||
echo " backend 仅启动后端服务"
|
||
echo " frontend 仅启动前端服务"
|
||
echo " build 构建嵌入前端的单二进制 $STANDALONE_BIN"
|
||
echo " binary 管理单二进制服务（start|stop|restart|status|upgrade）"
|
||
echo " status 查看服务状态"
|
||
echo " help 显示帮助信息"
|
||
echo ""
|
||
echo "示例:"
|
||
echo " ./run.sh # 启动所有服务"
|
||
echo " ./run.sh stop # 停止服务"
|
||
echo " ./run.sh restart # 重启服务"
|
||
echo " ./run.sh backend # 仅启动后端"
|
||
echo " ./run.sh build # 生成 ./opsx-licence"
|
||
echo " ./run.sh binary start # 启动单二进制服务"
|
||
}
|
||
|
||
# ============================================================
|
||
# 主入口
|
||
# ============================================================
|
||
main() {
|
||
local command=${1:-start}
|
||
|
||
case "$command" in
|
||
start)
|
||
info "========== $PROJECT_NAME 启动脚本 =========="
|
||
|
||
# 检查依赖
|
||
if ! command -v go &> /dev/null; then
|
||
error "Go 未安装，请先安装 Go"
|
||
exit 1
|
||
fi
|
||
if ! command -v npm &> /dev/null; then
|
||
error "npm 未安装，请先安装 Node.js"
|
||
exit 1
|
||
fi
|
||
|
||
if start_backend && start_frontend; then
|
||
echo ""
|
||
success "========== 所有服务已启动 =========="
|
||
info "前端地址: http://localhost:$FRONTEND_PORT"
|
||
info "后端地址: http://localhost:$BACKEND_PORT"
|
||
info "默认账号: admin / admin"
|
||
echo ""
|
||
info "使用 './run.sh stop' 停止服务"
|
||
else
|
||
error "服务启动失败"
|
||
exit 1
|
||
fi
|
||
;;
|
||
stop)
|
||
stop
|
||
;;
|
||
restart)
|
||
stop
|
||
sleep 2
|
||
main start
|
||
;;
|
||
backend)
|
||
info "========== $PROJECT_NAME (仅后端) =========="
|
||
start_backend
|
||
show_status
|
||
;;
|
||
frontend)
|
||
info "========== $PROJECT_NAME (仅前端) =========="
|
||
start_frontend
|
||
show_status
|
||
;;
|
||
build)
|
||
build_binary
|
||
;;
|
||
binary)
|
||
binary_command "${2:-start}"
|
||
;;
|
||
status)
|
||
show_status
|
||
;;
|
||
help|--help|-h)
|
||
show_help
|
||
;;
|
||
*)
|
||
error "未知命令: $command"
|
||
show_help
|
||
exit 1
|
||
;;
|
||
esac
|
||
}
|
||
|
||
main "$@"
|