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

Stripe 配置 (Stripe Billing Setup)

Stripe 相关服务端能力现在由 accounts.svc.plus 承担，包括：

Checkout Session 创建
Customer Portal 跳转
Webhook 验签与订阅状态回写

需要的环境变量：

变量	用途
`STRIPE_SECRET_KEY`	Stripe API secret key
`STRIPE_WEBHOOK_SECRET`	Stripe webhook endpoint secret
`STRIPE_ALLOWED_PRICE_IDS`	允许下单的 `price_...` 白名单，逗号分隔

联调说明见 docs/usage/stripe-billing.md。

核心特性 & 技术栈 (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
Stripe 联调：docs/usage/stripe-billing.md
部署方式：docs/usage/deployment.md
API 参考：docs/api/overview.md
运维：docs/operations/monitoring.md, docs/operations/troubleshooting.md
Runbooks：docs/Runbook/README.md

2.9 KiB Raw Permalink Blame History Unescape Escape