域名管理系统 - 集域名管理、WHOIS查询、ICP备案查询、价格比对、证书管理、到期通知于一体的综合平台。
- 域名管理 - 域名的增删改查、批量操作、CSV导入导出
- WHOIS查询 - 域名注册信息查询（依赖 next-whois；
*.pp.ua免费二级域名走 UANIC 官方 whois 服务器，即 dig.ua 的数据源） - ICP备案查询 - 域名备案信息查询（依赖 ICP_Query）
- 价格比对 - 多注册商域名续费价格对比（当前为估算参考价，非实时注册商报价）
- 注册商管理 - 注册商信息维护、域名批量导入
- 证书管理 - SSL证书管理，支持与 Certimate 同步
- 到期通知 - 多渠道域名到期提醒（邮件、Webhook等）
- 用户系统 - 多用户支持、角色权限管理
- 第三方登录 - 接入 OauthGo 或 彩虹聚合登录，支持 QQ / 微信 / Gitee 等渠道一键登录
- 系统设置 - 系统参数配置
后端
- Go 1.26 + Gin
- GORM + SQLite
- JWT 认证
前端
- React 18 + Vite
- Ant Design 5
- React Router
- axios
docker compose up -d包含三个服务：
- domain-manager - 主应用 (
xiaoman1221/domain-manager:latest) - whois - WHOIS查询服务 (
programzmh/next-whois-ui) - icp - ICP备案查询服务 (
yiminger/ymicp)
环境要求
- Go 1.26+
- Node.js 18+
- npm
配置
复制 .env.example 为 .env 并修改配置：
cp .env.example .env| 变量 | 说明 | 默认值 |
|---|---|---|
PORT |
服务端口 | 8080 |
GIN_MODE |
Gin模式（debug/release） | debug |
DB_PATH |
数据库文件路径 | domain_manager.db |
JWT_KEY |
JWT密钥（建议 openssl rand -hex 32 生成；不设置时每次启动随机生成，重启后所有登录失效） |
- |
运行时配置（迁移至数据库，管理员可在 个人设置 → 系统管理 → 系统设置 中修改，保存后立即生效）
系统设置按类别分组（个人设置 → 系统设置，仅管理员）：
| 分组 | 配置项 | 说明 |
|---|---|---|
| 基础 | WHOIS_API_URL / ICP_API_URL / DIGITALPLAT_RDAP_URL |
查询服务地址 |
| 第三方登录 | OAUTH_PROVIDER（oauthgo/rainbow） |
选择登录服务：OauthGo 或 彩虹聚合登录 |
| 第三方登录 | OAUTHGO_BASE_URL / APP_ID / APP_KEY / REDIRECT_URI |
OauthGo 配置（留空禁用） |
| 第三方登录 | RAINBOW_BASE_URL / APP_ID / APP_KEY / REDIRECT_URI |
彩虹聚合登录配置（留空禁用） |
| SMTP | SMTP_HOST / PORT / USERNAME / PASSWORD / FROM / FROM_NAME / ENCRYPTION / ENABLED |
全局 SMTP，作为邮件通知渠道的默认服务器 |
| 支付系统 | PAYMENT_PROVIDER / MERCHANT_ID / APP_ID / APP_KEY / NOTIFY_URL / ENABLED |
支付渠道配置（预留） |
| SNS | SNS_CONFIG |
社交平台链接（展示在登录页页脚） |
| 页脚 | FOOTER_DESCRIPTION / COPYRIGHT / ICP / POLICE / LINKS |
登录页页脚文案与链接 |
上述运行时配置在首次启动时以
.env中的值为默认值写入数据库，之后以数据库为准。
构建运行
后端通过
//go:embed web/dist/*内嵌前端构建产物，因此go build前必须先构建前端。
# 一键构建（前端+后端）
make
# 或
bash build.sh
# 运行
./domain-manager首次运行会自动创建管理员账号：
- 用户名：
admin - 密码：
123456
请登录后立即修改默认密码。
本系统支持通过 OauthGo 或 彩虹聚合登录（兼容 u.cccyun.cc 的 connect.php 协议）接入第三方登录（QQ、微信、Gitee、Google、GitHub 等渠道）。
-
在 系统设置 → 第三方登录 中通过
OAUTH_PROVIDER选择登录服务（oauthgo或rainbow）。 -
在对应平台注册应用，获得
APP_ID/APP_KEY，并将本系统地址加入回调域名白名单（默认回调路径为/api/auth/oauth/callback）。 -
配置所选服务（两种方式任选，数据库保存后立即生效）：
- 首次启动前：在
.env中填写（作为初始默认值写入数据库），或 - 启动后：在 个人设置 → 系统管理 → 系统设置 中填写对应服务的地址与应用凭证。
- 首次启动前：在
-
登录弹窗中会出现「或使用第三方账号登录」入口。
首次通过第三方渠道登录会自动创建本地账号（默认普通用户角色组），之后同一渠道账号会直接登录并自动更新昵称/头像。
可在 系统设置 → 第三方登录 中勾选「启用登录方式」，控制登录弹窗中展示的第三方渠道；不勾选时展示所选服务已开启的全部渠道。
登录后在 个人设置 → 第三方登录 中可绑定/解绑多个第三方账号，绑定后可直接用该账号登录。
- 角色组（role_group）：决定访问权限，取值
admin（管理员）或user（普通用户）。系统设置、用户管理等后端管理功能仅角色组为管理员的用户可访问。 - 用户组（user_group）：用于组织标记（如「运维组」「运营组」），仅作标识，不影响权限。可在 个人设置 → 系统管理 → 用户管理 中为每个用户设置。
首次部署时自动创建的管理员账号属于 admin 角色组；通过第三方登录创建的账号默认属于 user 角色组。
用户管理（/users）页面支持查看、编辑（昵称/邮箱/角色组/用户组）与删除用户，仅管理员角色组可用；不能删除当前登录账号或最后一个管理员。
- 用户管理、系统设置、系统信息、Certimate 配置/同步等接口仅管理员可用。
- 注册商数据按用户隔离，互不可见。
- 登录/注册接口有基于 IP 的限流保护。
| 模块 | 路径前缀 | 说明 |
|---|---|---|
| 认证 | /api/auth |
注册、登录、获取用户信息 |
| 域名 | /api/domains |
域名CRUD、批量操作、导入导出 |
| WHOIS | /api/whois |
WHOIS查询 |
| ICP | /api/icp |
ICP备案查询 |
| 价格 | /api/price |
域名价格查询与比对 |
| 注册商 | /api/registrars |
注册商管理 |
| 证书 | /api/certificates |
证书管理、Certimate同步 |
| 通知 | /api/notifications |
通知渠道与日志管理 |
| 设置 | /api/settings |
系统设置、用户管理 |
DomainManager/
├── config/ # 配置加载
├── database/ # 数据库初始化与迁移
├── handlers/ # 请求处理器
├── middleware/ # 中间件（JWT认证）
├── models/ # 数据模型
├── router/ # 路由定义
├── services/ # 业务逻辑（WHOIS/ICP/价格等）
├── utils/ # 工具函数
├── web/ # React 前端
│ ├── src/
│ │ ├── api/ # 接口封装
│ │ ├── pages/ # 页面
│ │ ├── layouts/ # 主布局
│ │ └── utils/ # 头像/格式化等
│ └── dist/ # 前端构建产物
├── .env.example # 环境变量模板
├── go.mod
└── main.go
MIT