Files
gitlab-instance-0a899031_di…/docs/PRODUCTION_ENV_CONFIG.md
2026-03-12 05:40:18 -05:00

134 lines
3.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 生产环境配置指南
各项目在部署到生产环境时,需在项目根目录创建 `.env.local`(或 `.env.production`),并配置以下变量。
---
## 一、digital数字游民指南
路径:`digital/.env.local`
```bash
# ========== 根域与 Cookie跨站 SSO 必填)==========
ROOT_DOMAIN=hackrobot.cn
AUTH_COOKIE_DOMAIN=.hackrobot.cn
# ========== PocketBase ==========
NEXT_PUBLIC_POCKETBASE_URL=https://pocketbase.hackrobot.cn
POCKETBASE_EMAIL=你的PocketBase管理员邮箱
POCKETBASE_PASSWORD=你的PocketBase管理员密码
# ========== 支付payjsapi==========
PAYMENT_API_URL=https://api.hackrobot.cn
# ========== 站点 ==========
NEXT_PUBLIC_SITE_ID=digital
NEXT_PUBLIC_SITE_URL=https://digital.hackrobot.cn
```
---
## 二、cnomadcna游牧中国
路径:`cnomadcna/.env.local`
```bash
# ========== 根域与 Cookie跨站 SSO 必填)==========
ROOT_DOMAIN=hackrobot.cn
AUTH_COOKIE_DOMAIN=.hackrobot.cn
# ========== PocketBase ==========
NEXT_PUBLIC_POCKETBASE_URL=https://pocketbase.hackrobot.cn
POCKETBASE_EMAIL=你的PocketBase管理员邮箱
POCKETBASE_PASSWORD=你的PocketBase管理员密码
# ========== 支付payjsapi==========
PAYMENT_API_URL=https://api.hackrobot.cn
# ========== 站点 ==========
NEXT_PUBLIC_SITE_ID=meetup
NEXT_PUBLIC_SITE_URL=https://meetup.hackrobot.cn
```
---
## 三、nomadvip异度星球
路径:`nomadvip/.env.local`
```bash
# ========== 根域与 Cookie跨站 SSO 必填)==========
AUTH_COOKIE_DOMAIN=.hackrobot.cn
# ========== PocketBase ==========
NEXT_PUBLIC_POCKETBASE_URL=https://pocketbase.hackrobot.cn
# ========== 支付payjsapi==========
PAYMENT_API_URL=https://api.hackrobot.cn
NEXT_PUBLIC_API_URL=https://api.hackrobot.cn
# ========== 站点 ==========
NEXT_PUBLIC_SITE_ID=vip
```
---
## 四、payjsapi支付后端
路径:`payjsapi/.env`
```bash
# ========== 回调地址ZPAY 异步通知必填)==========
BASE_URL=https://api.hackrobot.cn
# ========== 支付渠道 ==========
PAYMENT_PROVIDER=zpay
# ========== ZPAY ==========
ZPAY_PID=你的ZPAY商户ID
ZPAY_KEY=你的ZPAY密钥
# ========== PocketBase ==========
PB_URL=https://pocketbase.hackrobot.cn
PB_ADMIN_EMAIL=你的PocketBase管理员邮箱
PB_ADMIN_PASSWORD=你的PocketBase管理员密码
# ========== Memosnomadvip 专用,可选)==========
# MEMOS_API=...
# MEMOS_TOKEN=...
```
---
## 五、变量说明
| 变量 | 作用 | 说明 |
|------|------|------|
| AUTH_COOKIE_DOMAIN | 跨站 SSO | 设为 `.hackrobot.cn`,三站共享登录态 |
| POCKETBASE_EMAIL / POCKETBASE_PASSWORD | VIP 查询 | 需 PocketBase 管理员账号,用于 `/api/vip/check` |
| PAYMENT_API_URL | 支付接口 | payjsapi 部署地址 |
| NEXT_PUBLIC_SITE_ID | VIP 隔离 | digital / meetup / vip |
---
## 六、配置步骤
1. 在对应项目根目录创建 `.env.local`Next.js 项目)或 `.env`payjsapi
2. 复制上述示例,按实际域名和账号修改
3. 重启服务使配置生效
```bash
# 示例digital 项目
cd digital
cp .env.example .env.local # 或手动创建
# 编辑 .env.local 填入生产配置
```
---
## 七、注意事项
- `.env.local` 已在 `.gitignore` 中,不会被提交
- 更换域名时,同时修改 `ROOT_DOMAIN``AUTH_COOKIE_DOMAIN`(如 `.nomadro.com`
- 确保域名解析到正确服务器nginx 反向代理指向 `https://api.hackrobot.cn` → payjsapi 端口(如 8700