HL6 是一个域名/子域名管理平台。用户可以在已注册域名下认领并管理子域名、维护 DNS 记录，并基于积分规则控制访问；管理员可进行全局管理。 fork from https://git.houlang.cloud/houlangcloud/hl6
- 域名与子域名管理
- DNS 记录管理（A / AAAA / CNAME / TXT）
- 基于积分的访问控制
- 用户与管理员角色权限
- 多语言前端（i18next）
- 前端：React 19 + TypeScript + Vite + Tailwind CSS 4 + TanStack React Query
- 后端：Go（Gin + GORM）+ PostgreSQL 16
- 认证：OIDC 兼容（支持 Logto、Keycloak、Authentik、Google、Zitadel 等）+ JWT
- 基础设施：Docker Compose（本地 PostgreSQL）
根目录 .env.example 提供了默认模板：
| 变量名 | 说明 |
|---|---|
DATABASE_URL |
PostgreSQL 连接串 |
SERVER_PORT |
后端服务端口（默认 8080） |
APP_URL |
可选公共地址；当 FRONTEND_URL 或 BACKEND_URL 未设置时，作为对应侧的兜底值 |
OIDC_ISSUER |
可选；OIDC 提供商 Issuer URL（如 Logto、Keycloak、Google 等） |
OIDC_CLIENT_ID |
可选；OIDC 应用 Client ID |
OIDC_CLIENT_SECRET |
可选；OIDC 应用 Client Secret |
SESSION_SECRET |
会话密钥首启种子（可留空；仅在数据库未初始化密钥时使用） |
FRONTEND_URL |
可选；前端地址，设置后优先使用环境变量值（支持多地址，逗号/换行分隔） |
BACKEND_URL |
可选；后端对外地址，设置后优先使用环境变量值（支持多地址，逗号/换行分隔） |
ALLOWED_ORIGINS |
CORS 白名单（逗号分隔） |
ENCRYPTION_KEY |
可选；64 位十六进制字符串（32 字节），有值则加密 Cloudflare Token / OIDC Client Secret 等敏感配置 |
注意：Vite 配置使用
envDir: ".."，前端会读取项目根目录.env。 注意：系统中首个注册用户会自动成为管理员，后续注册用户默认是普通用户。 注意：运行时 URL 优先级为FRONTEND_URL/BACKEND_URL（含APP_URL兜底）> 数据库配置 > 自动探测并落库。管理员首次登录或地址变化时需要在面板确认一次当前生效地址。 注意：OIDC 运行时优先级为字段级环境变量 > 数据库。环境变量已设置的字段不能通过外部接口覆盖；环境变量未设置的字段可由管理员在面板维护。 注意：当 OIDC 环境变量与数据库都缺失时，且系统中还没有任何用户，登录页会弹出 OIDC 初始化向导；一旦系统已有用户，匿名初始化入口会关闭。 注意：服务会在数据库中维护内部会话密钥（_internal_session_secret）。首次启动如果该键不存在，会使用SESSION_SECRET作为一次性种子；若SESSION_SECRET为空则自动生成随机密钥。后续启动以数据库值为准。 注意：如果数据库数据丢失，内部会话密钥会重建，所有已登录会话将失效并需要重新登录。
- 镜像启动后默认监听
8080 - 同域部署时，只需设置
APP_URL，并让ALLOWED_ORIGINS包含该地址 - 仍然需要独立的 PostgreSQL 实例，
DATABASE_URL必填 - 快速部署（Docker Compose）见 docs/docker-compose-quickstart.md
.
├── server/ # Go 后端
│ ├── cmd/server/ # 程序入口
│ ├── internal/ # handler/service/repository/router 等
│ └── pkg/ # 公共包（response/validator）
├── web/ # React 前端
│ └── src/ # pages/components/hooks/lib/i18n/types
├── docker-compose.yml # 本地 PostgreSQL
├── Makefile # 开发命令入口
└── .env.example # 环境变量模板
本项目采用 GNU Affero General Public License v3.0（AGPL-3.0）开源协议，详见根目录 LICENSE 文件。