后端主入口为 cmd/api/main_entry.go
用户前台已接入 reference/LDNET-GA-Theme/theme/Nebula 主题资源
后台已改为 Go 直接提供的统一布局，并将 plugin 页面合并到左侧栏
Nebula 前端依赖的核心接口已补齐：
- 登录、注册、找回密码、邮箱验证码
- 用户信息、订阅、统计、节点、知识库、工单
- 活跃会话查询与撤销
- 实名认证、在线设备、IPv6 订阅 plugin API

目录说明

cmd/api: API 启动入口
internal/handler: Gin 处理器
internal/service: 业务服务，包括插件、会话、配置等
internal/model: GORM 数据模型
frontend/theme/Nebula: 前台主题静态资源
frontend/admin: 后台统一布局的静态资源
frontend/templates: 用户前台与后台页面模板
reference: 原始参考项目与主题/plugin 实现
docs/API.md: API 文档

运行方式

配置 .env
启动：

go run ./cmd/api

或：

go build ./cmd/api
.\api.exe

默认读取 .env 中的 MySQL、Valkey/Redis 与应用配置。

安装脚本

仓库已提供两个 Linux 脚本：

scripts/build_install.sh：在仓库当前目录下载 Go 工具链并编译 api
scripts/install.sh：针对自动化构建产物目录执行安装

从源码构建：

bash scripts/build_install.sh

从自动化构建产物安装：

cd package
sudo bash ./install.sh --install-dir /opt/singbox-gopanel --run-user root

脚本会执行这些步骤：

在 /opt 下创建安装目录及其 frontend、docs 子目录
复制 api、frontend、docs、README.md 与 .env.example
在安装目录生成 .env
安装并重启 systemd 服务

默认 service 名称是 singbox-gopanel，可通过 --service-name 修改。

Gitea Actions

仓库已新增 Gitea workflow：

.gitea/workflows/build.yml

当前 workflow 会：

执行 go build ./cmd/api
执行 go build ./...
构建 Linux amd64 / arm64 二进制
按平台输出目录化制品，例如 singbox-gopanel-linux-amd64/
将二进制、frontend、docs、.env.example、install.sh 直接作为 artifact 上传
不再额外生成 zip / tar.gz

当前远端开发环境

以下信息基于 2026-04-17 对远端环境的实际核对：

开发服务器：10.32.100.3
SSH：使用仓库内 AIAgentKey.pem
数据库：xboard
数据库密码：11223456
当前 v2_settings.secure_path：helloadmin
当前 v2_settings.app_name：LDNET-GA
当前 real_name_verification、user_online_devices、user_add_ipv6_subscription 三个 plugin 均为启用状态

前台与后台页面

用户前台：/
用户前台备用入口：/dashboard
后台入口：/{secure_path}
- 远端当前值是 /helloadmin

后台左侧栏已整合：

总览
实名认证
在线设备
IPv6 订阅
Plugin 集成状态

Plugin 集成结论

已完成

RealNameVerification
- 用户查询状态
- 用户提交实名信息
- 管理端记录查询、通过、驳回、重置、批量同步、批量通过
- auto_approve、allow_resubmit_after_reject、enforce_real_name、verified_expiration_date 已接入
UserOnlineDevices
- 用户在线 IP 查询
- 管理端用户在线设备监控
- 与新的活跃会话能力联动输出 session_overview
UserAddIPv6Subscription
- 用户资格检查
- 手动启用
- IPv6 子账号密码同步
- 运行时影子账号自动同步

仍需后续完整订单流配合

UserAddIPv6Subscription 的“订单完成后立即自动创建 IPv6 子账号”这一点，仍然依赖后续订单生命周期重构完全落地后再补最终钩子。

已完成的主要改动

新增 Nebula 前台页面模板与静态资源接入
新增统一后台页面与左侧栏 plugin 入口
补充知识库、工单、活跃会话相关接口
补充 token 快速登录、邮箱验证码、找回密码接口
为 JWT 登录补充基于缓存的会话跟踪与撤销能力
调整实名插件逻辑，贴近参考配置行为
输出 plugin 集成状态接口，便于后台与文档统一核对

验证

已完成：

go build ./cmd/api
go build ./...

说明：

本地编译已通过
本地实际连远端 DB/Valkey 的完整页面联调仍建议在目标服务器或等价网络环境下继续验证

2026-04 parity addendum

This pass added another backend parity sweep against reference/Xboard.

Added in this round:

passport quick-login URL, mail-link compatibility, and invite PV tracking
user notice, invite, traffic-log, order, coupon, Telegram bot info, Stripe public key, and quick-login compatibility endpoints
admin config save support backed by v2_settings
missing GORM models for v2_notice, v2_invite_code, v2_payment, v2_commission_log, v2_stat_user, and v2_coupon

Validation after the changes:

go build ./cmd/api
go build ./...

README.md Unescape Escape

SingBox-Gopanel

当前状态