| .agent/docs | ||
| .github | ||
| ansible | ||
| api | ||
| cmd | ||
| config | ||
| deploy | ||
| docs | ||
| internal | ||
| scripts | ||
| skills | ||
| sql | ||
| tests/e2e/superadmin-login | ||
| .env.example | ||
| .gitignore | ||
| .gitleaksignore | ||
| .gitmodules | ||
| accounts-svc-plus-remote.yaml | ||
| ansible.cfg | ||
| api.test | ||
| Dockerfile | ||
| entrypoint.sh | ||
| go.mod | ||
| go.sum | ||
| LICENSE | ||
| Makefile | ||
| preview-accounts-svc-plus-remote.yaml | ||
| README.md | ||
accounts.svc.plus
Cloud Neutral Toolkit 的账号与身份服务 (Account Service).
A production-oriented account service for sign-in, sessions, MFA, and agent coordination.
部署要求 (Deployment Requirements)
| 维度 | 要求 / 规格 | 说明 |
|---|---|---|
| 网络 | 可访问的 API 域名 (可选) | 生产建议配置 server.publicUrl |
| 端口 | :8080 |
API 服务默认监听端口 |
| 数据库 | PostgreSQL | 存储账号/会话/状态等核心数据 |
| 缓存 (可选) | Redis | session.cache=redis 时需要 |
| 最低 | 1 CPU / 1GB RAM | 开发/小规模 |
| 推荐 | 2 CPU / 2GB RAM | 生产建议 |
快速开始 (Quickstart)
一键初始化 (Setup Script)
curl -fsSL "https://raw.githubusercontent.com/cloud-neutral-toolkit/accounts.svc.plus/main/scripts/setup.sh?$(date +%s)" \
| bash -s -- accounts.svc.plus --mode process --deploy
Docker 部署模式：
curl -fsSL "https://raw.githubusercontent.com/cloud-neutral-toolkit/accounts.svc.plus/main/scripts/setup.sh?$(date +%s)" \
| bash -s -- accounts.svc.plus --mode docker --deploy
Cloud Run 部署模式：
curl -fsSL "https://raw.githubusercontent.com/cloud-neutral-toolkit/accounts.svc.plus/main/scripts/setup.sh?$(date +%s)" \
| bash -s -- accounts.svc.plus --mode cloudrun
单机 process / docker 模式默认会写入 Caddy 站点配置到 /etc/caddy/conf.d/accounts.svc.plus.conf，并反向代理到本机 127.0.0.1:8080。
本地运行 (Local Dev)
cp .env.example .env
make dev
核心特性 & 技术栈 (Features & Tech Stack)
核心特性：
- 账号体系：注册/登录/会话/角色与权限
- 安全能力：邮件验证、TOTP MFA（可选）
- Agent 协同：与节点/控制面协作的同步与状态上报
- 多部署形态：本地/VM、Docker、Cloud Run（含 stunnel sidecar 示例）
技术栈：
- Go + Gin
- PostgreSQL (primary store)
- Redis (optional session cache)
- stunnel (optional secure DB connectivity; Cloud Run example included)
说明文档 (Docs)
- 文档入口：
docs/README.md - 快速开始：
docs/getting-started/quickstart.md - 配置说明：
docs/usage/config.md - 部署方式：
docs/usage/deployment.md - API 参考：
docs/api/overview.md - 运维：
docs/operations/monitoring.md,docs/operations/troubleshooting.md - Runbooks：
docs/Runbook/README.md