feat: 完成 opsx-licence 许可证管理平台全栈实现
基于 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
This commit is contained in:
Logan.Li committed
commit
4ae318335c
88 files changed
+10562
No files matched your search
@@ -0,0 +1,406 @@
|
||||
#!/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 "$@"
|
||||
Reference in new issue
Block a user