- 新增 POST /api/auth/wechat/login:用 wx.login 的 code 换 openid;已绑定直接签发 JWT 返回,未绑定返回 bindToken - bind.post.ts:支持从请求体读取 bindToken(小程序不便维护 cookie),绑定成功后返回 token,供 Authorization: Bearer 使用 - auth-route-policy.ts:把新接口登记进免鉴权白名单,否则会被鉴权中间件拦截 - .env.example:新增 WECHAT_MINI_APPID / WECHAT_MINI_SECRET
124 lines
5.1 KiB
Bash
124 lines
5.1 KiB
Bash
# 数据库连接地址(必填)
|
||
# 格式:postgresql://用户名:密码@主机:端口/数据库名?sslmode=require
|
||
# 示例:postgresql://myuser:mypassword@localhost:5432/voicehub?sslmode=require
|
||
DATABASE_URL="postgresql://username:password@host:port/database?sslmode=require"
|
||
|
||
# JWT 认证密钥(必填)
|
||
# 请使用强随机字符串,建议至少 32 位
|
||
JWT_SECRET="your-very-secure-jwt-secret-key"
|
||
|
||
# 受信的 CDN/反向代理真实 IP 头(可选)
|
||
# 多个头用逗号分隔;未配置时只使用 TCP 连接地址,避免客户端伪造转发头。
|
||
# 示例:EdgeOne 使用 eo-connecting-ip,Cloudflare 使用 cf-connecting-ip
|
||
# TRUSTED_CLIENT_IP_HEADERS=eo-connecting-ip
|
||
|
||
# WebAuthn / Passkey 配置(可选)
|
||
# 依赖方 ID (RP ID),必须是你域名的一个有效域名
|
||
# 规则:必须是请求域名的精确匹配或父域名
|
||
#
|
||
# 示例:
|
||
# - 请求域名为 voicehub.example.com,RP ID 可设为 voicehub.example.com 或 example.com
|
||
# - 不配置时,默认使用当前请求的 hostname(适合开发/预览环境)
|
||
# - 生产环境建议配置为你的主域名,如:voicehub.example.com
|
||
WEBAUTHN_RP_ID=
|
||
|
||
# 允许的 Origin 列表(可选)
|
||
# WebAuthn 要求精确匹配 Origin,此配置用于支持多域名部署
|
||
# 多个域名用逗号分隔,必须包含 https:// 前缀
|
||
#
|
||
# 示例:
|
||
# - 单域名:https://voicehub.example.com
|
||
# - 多域名(Vercel 预览 + 生产):https://voicehub.example.com,https://voicehub-xxx.vercel.app
|
||
# - 二级域名:https://voicehub.example.com,https://sub.voicehub.example.com
|
||
#
|
||
# 不配置时:默认信任请求的 Origin(适合开发环境)
|
||
# 生产环境:强烈建议配置,以防止恶意站点伪造 Origin 攻击
|
||
WEBAUTHN_ORIGIN=
|
||
|
||
# 应用运行环境(可选)
|
||
# development: 开发环境
|
||
# production: 生产环境
|
||
NODE_ENV=development
|
||
|
||
# Sentry 配置(可选)
|
||
# 错误监控与性能追踪,配置后系统将自动上报运行时异常
|
||
#
|
||
# SENTRY_DSN 客户端(浏览器)使用的 DSN(公开可暴露)
|
||
# 示例:https://publicKey@o0.ingest.sentry.io/0
|
||
# SENTRY_DSN=
|
||
#
|
||
# SENTRY_SERVER_DSN 服务端(Node)使用的 DSN(保密,不应暴露给浏览器)
|
||
# 如未单独配置,服务端会自动降级使用 SENTRY_DSN
|
||
# SENTRY_SERVER_DSN=
|
||
#
|
||
# 采样率配置(0~1 的小数,默认 1.0 表示 100%)
|
||
# 错误采样率
|
||
# SENTRY_ERROR_SAMPLE_RATE=1.0
|
||
# 性能追踪(Traces)采样率
|
||
# SENTRY_TRACES_SAMPLE_RATE=1.0
|
||
# 浏览器会话回放(Replay)采样率,需同时设置下面两项才会生效
|
||
# 生产环境建议分别设为 0.1 和 1.0,即 10% 正常用户 + 100% 错误用户进行回放
|
||
# SENTRY_REPLAY_SESSION_SAMPLE_RATE=
|
||
# SENTRY_REPLAY_ON_ERROR_SAMPLE_RATE=
|
||
#
|
||
# 项目版本号,用于区分不同版本的错误;未填时自动使用 package.json 的 version
|
||
# SENTRY_RELEASE=
|
||
#
|
||
# 环境标签,默认继承 NODE_ENV
|
||
# SENTRY_ENVIRONMENT=
|
||
|
||
# Redis 缓存服务(可选,暂不推荐)
|
||
# 如果设置了 REDIS_URL,系统将自动启用 Redis 缓存功能
|
||
# 格式:redis://用户名:密码@主机:端口
|
||
# REDIS_URL="redis://default:password@host:port"
|
||
|
||
# Docker Compose 自带的 Redis 容器(compose 自带 redis 服务,仅在启用自带 redis 时用)
|
||
# - 留空(或空字符串):不设置 Redis 密码,内网部署常用(默认)
|
||
# - 填写强密码:Redis 会启用 requirepass,连接时 REDIS_URL 里也要带上相同密码
|
||
REDIS_PASSWORD=
|
||
|
||
# Redis 键命名空间,多个 VoiceHub 环境共用 Redis 时应分别设置
|
||
# REDIS_KEY_PREFIX="voicehub:v2:"
|
||
|
||
# OAuth 配置(可选)
|
||
# 启用相应的 OAuth 提供商需要填写对应的 Client ID 和 Client Secret
|
||
#
|
||
# 注意:OAuth 运行时配置已经迁移到管理员后台;以下变量仅用于兼容旧部署和后台一键导入。
|
||
# 导入完成后,系统以数据库中保存的配置为准。
|
||
|
||
# OAuth 回调地址(必填,如果启用 OAuth)
|
||
# 注意:[provider] 是占位符,实际使用时需要根据具体情况填写
|
||
OAUTH_REDIRECT_URI="http://localhost:3000/api/auth/[provider]/callback"
|
||
|
||
# 用于加密 OAuth state 的密钥(必填,如果启用 OAuth)
|
||
OAUTH_STATE_SECRET=your-secure-random-string-for-oauth-state
|
||
|
||
# GitHub OAuth
|
||
GITHUB_CLIENT_ID=
|
||
GITHUB_CLIENT_SECRET=
|
||
|
||
# Casdoor OAuth
|
||
CASDOOR_CLIENT_ID=
|
||
CASDOOR_CLIENT_SECRET=
|
||
CASDOOR_ENDPOINT=
|
||
|
||
# Google OAuth
|
||
GOOGLE_CLIENT_ID=
|
||
GOOGLE_CLIENT_SECRET=
|
||
|
||
# 聚合登陆 OAuth(如 auxx.cn 等聚合登录服务,支持微信/QQ 等通道
|
||
AGGREGATE_OAUTH_APP_ID=
|
||
AGGREGATE_OAUTH_APP_KEY=
|
||
# 支持单值、逗号分隔或 JSON 数组,例如:qq,wx,sina,baidu
|
||
# 可用值:qq,wx,alipay,sina,baidu,douyin,huawei,xiaomi,gitee,gitea,bilibili,kuaishou
|
||
AGGREGATE_OAUTH_LOGIN_TYPE=wx
|
||
# 聚合登录服务基地址(https,不带 /oauth/... 路径),例如:https://www.auxx.cn
|
||
AGGREGATE_OAUTH_ENDPOINT=
|
||
|
||
# 微信小程序登录(可选)
|
||
# 用于小程序端 wx.login() 的 code 换取 openid,对应接口 POST /api/auth/wechat/login
|
||
# AppID / AppSecret 在微信公众平台「开发管理 → 开发设置 → 开发者ID」中获取
|
||
# 注意:这与上方聚合登录的 wx 通道不是一回事——小程序 openid 按 AppID 维度生成,两者不通用
|
||
WECHAT_MINI_APPID=
|
||
WECHAT_MINI_SECRET=
|