Go to file
2026-02-10 11:52:45 +08:00
.agent/docs feat(agent-persistence): implement PostgreSQL persistence for agent registry 2026-02-05 08:34:25 +08:00
.github deployment with GitHub Actions, Stunnel for TLS database connections, and dynamic configuration injection. 2026-01-20 21:05:30 +08:00
api fix(experience): consolidate demo account into sandbox@svc.plus 2026-02-10 11:52:45 +08:00
cmd fix(experience): consolidate demo account into sandbox@svc.plus 2026-02-10 11:52:45 +08:00
config feat: Implement database session fallback for token validation in the authentication middleware. 2026-02-06 22:16:28 +08:00
deploy chore: commit pending agent/controller updates and docs 2026-02-05 16:56:17 +08:00
docs chore(tests): move integration tests to tests/e2e 2026-02-09 11:29:29 +08:00
internal feat: Add local-test.yaml configuration, modify user not found API response to include mfa_enabled status, and add 5xx error logging. 2026-02-06 22:31:50 +08:00
scripts docs(setup): add root README and setup script 2026-02-09 11:29:36 +08:00
skills feat: add git security and commit standards skills and hooks 2026-01-30 10:10:43 +08:00
sql feat: Implement persistent session management by moving session logic to the store interface and adding a sessions table. 2026-02-05 11:27:11 +08:00
tests/e2e/superadmin-login chore(tests): move integration tests to tests/e2e 2026-02-09 11:29:29 +08:00
.env.example docs(setup): add root README and setup script 2026-02-09 11:29:36 +08:00
.gitignore Merge branch 'codex/fix/sandbox-sync-all-regions' 2026-02-09 11:13:21 +08:00
.gitleaksignore chore: ignore false positive secrets in historical LOGIN_API_GUIDE.md 2026-01-30 23:17:05 +08:00
.gitmodules Add NeuraPress submodule metadata (#794) 2025-12-14 21:01:34 +08:00
api.test test: Replace hardcoded test password with a named variable in api_test.go and add api.test. 2026-02-06 12:29:10 +08:00
Dockerfile build: bump go builder image to 1.25.1 2026-01-23 23:34:46 +08:00
entrypoint.sh feat: Default DB_HOST to 127.0.0.1 and DB_PORT to 15432 to ensure stunnel wait. 2026-01-31 13:36:28 +08:00
go.mod feat: add user management APIs for management page 2026-01-30 08:59:55 +08:00
go.sum feat: implement user management features (pause, delete, blacklist, renew uuid) 2026-02-02 20:19:06 +08:00
LICENSE feat: Add Apache License 2.0 to the project. 2026-02-02 18:09:42 +08:00
Makefile chore(tests): move integration tests to tests/e2e 2026-02-09 11:29:29 +08:00
README.md docs(setup): add root README and setup script 2026-02-09 11:29:36 +08:00

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

本地运行 (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
  • Runbooksdocs/Runbook/README.md