Hivechat

🚀 如何在本地和 Vercel 平臺安裝與部署 HiveChat 系統

本指南將詳細介紹如何在本地環境安裝 HiveChat 系統，以及如何將其部署到 Vercel 平臺，同時包含第三方登錄配置說明和注意事項。

🚀 快速開始

📦 本地安裝步驟

1. 安裝 PostgreSQL 數據庫

• 下載並安裝 PostgreSQL（推薦版本：12 或更高）。
• 創建一個新的數據庫，例如 hivechat。
• 將以下環境變量填入 .env 文件：

DATABASE_URL=postgres://username:password@localhost/hivechat

2. 配置環境變量

在項目根目錄下創建一個 .env 文件，並添加以下內容（請根據實際值替換佔位符）：

# 數據庫連接 URL
DATABASE_URL=postgres://username:password@localhost/hivechat

# 加密密鑰
AUTH_SECRET=hclqD3nBpMphLevxGWsUnGU6BaEa2TjrCQ77weOVpPg=

# 管理員授權碼
ADMIN_CODE=22113344

# 生產環境域名（請根據實際域名填寫）
NEXTAUTH_URL=http://localhost:3000

# 郵箱登錄開關
EMAIL_AUTH_STATUS=ON

# 第三方登錄配置（請根據實際情況填寫）
FEISHU_AUTH_STATUS=OFF
FEISHU_CLIENT_ID=cli_xxxxxxxxxxxxxxxx
FEISHU_CLIENT_SECRET=xxxxxxxxHOEWIoE7eDc1Lhc0042OXXXX

WECOM_AUTH_STATUS=OFF
WECOM_CLIENT_ID=ww728c371c2fXXXXXX
WECOM_AGENT_ID=100XXXX
WECOM_CLIENT_SECRET=H-7J4jzG0m1axpXLGshaCDlMOZxdjvkX6bIVLuXXXXXX

DINGTALK_AUTH_STATUS=OFF
DINGTALK_CLIENT_ID=dingpcfi2kpuplXXXXXX
DINGTALK_CLIENT_SECRET=3vk9-VFCExNckqNUk_CL2F-HEgz7qGN-BimH0lZ1g_an2lnkk6XXXXXX

3. 啟動系統

在終端中運行以下命令：

npm install
npm run dev

啟動完成後，訪問 http://localhost:3000/setup 進行管理員賬號設置。

🚀 Vercel 平臺部署步驟

1. 創建 Neon 數據庫

• 登錄 Vercel 控制檯，在頂部導航欄選擇「Storage」標籤，點擊「Create Database」。
• 選擇「Neon (Serverless Postgres)」並完成創建。

2. 配置環境變量

在項目設置中填寫以下環境變量（請根據實際情況填寫）：

# 數據庫連接 URL（從 Neon 控制檯獲取）
DATABASE_URL=postgres://postgres:password@localhost/hivechat

# 加密密鑰
AUTH_SECRET=hclqD3nBpMphLevxGWsUnGU6BaEa2TjrCQ77weOVpPg=

# 管理員授權碼
ADMIN_CODE=22113344

# 生產環境域名（請根據實際域名填寫）
NEXTAUTH_URL=http://localhost:3000

# 郵箱登錄開關
EMAIL_AUTH_STATUS=ON

# 第三方登錄配置（請根據實際情況填寫）
FEISHU_AUTH_STATUS=OFF
FEISHU_CLIENT_ID=cli_xxxxxxxxxxxxxxxx
FEISHU_CLIENT_SECRET=xxxxxxxxHOEWIoE7eDc1Lhc0042OXXXX

WECOM_AUTH_STATUS=OFF
WECOM_CLIENT_ID=ww728c371c2fXXXXXX
WECOM_AGENT_ID=100XXXX
WECOM_CLIENT_SECRET=H-7J4jzG0m1axpXLGshaCDlMOZxdjvkX6bIVLuXXXXXX

DINGTALK_AUTH_STATUS=OFF
DINGTALK_CLIENT_ID=dingpcfi2kpuplXXXXXX
DINGTALK_CLIENT_SECRET=3vk9-VFCExNckqNUk_CL2F-HEgz7qGN-BimH0lZ1g_an2lnkk6XXXXXX

3. 部署系統

完成上述配置後，推送到代碼倉庫並觸發 Vercel 自動部署。

🔌 第三方登錄配置說明

1. 微信企業版（WECOM）

• 登錄微信企業版後臺，創建應用並獲取 Client ID 和 Client Secret。
• 將這些值填入環境變量中：

WECOM_AUTH_STATUS=ON
WECOM_CLIENT_ID=ww728c371c2fXXXXXX
WECOM_AGENT_ID=100XXXX
WECOM_CLIENT_SECRET=H-7J4jzG0m1axpXLGshaCDlMOZxdjvkX6bIVLuXXXXXX

2. 飛書（DINGTALK）

• 登錄飛書開發者後臺，創建應用並獲取 Client ID 和 Client Secret。
• 將這些值填入環境變量中：

DINGTALK_AUTH_STATUS=ON
DINGTALK_CLIENT_ID=dingpcfi2kpuplXXXXXX
DINGTALK_CLIENT_SECRET=3vk9-VFCExNckqNUk_CL2F-HEgz7qGN-BimH0lZ1g_an2lnkk6XXXXXX

⚠️ 注意事項

⚠️ 重要提示

• 確保所有環境變量值正確無誤。
• 定期備份數據庫以防止數據丟失。
• 部署完成後，建議測試各項功能（例如：管理員登錄、第三方登錄等）。

如果有任何問題，請參考 官方文檔 或聯繫技術支持。