chore: 完善 WPS 绑定验证码配置的文档说明与变量示例

This commit is contained in:
2026-01-20 11:42:23 +08:00
parent 2cb67635a6
commit 8402dbd0b1
2 changed files with 28 additions and 13 deletions

View File

@@ -26,17 +26,29 @@ bun x wrangler login
### 3. 设置密钥 (Secrets) ### 3. 设置密钥 (Secrets)
为了安全GoToSocial 的地址和访问令牌需要作为密钥存储在 Cloudflare 中 部署此 Worker 需要3个密钥
```bash 1. **登录 WPS 后台,找到 `bind_code`**
# 1. 设置你的 GoToSocial 实例 API 地址 * 在WPS表单的“数据推送”设置页面您会看到一行说明其中包含 `bind_code` 和一长串数字,像这样:
# 示例: https://your-domain.com/api/v1/statuses `{"bind_code":"20260119203041975010606"}`
bun x wrangler secret put GOTOSOCIAL_URL * **复制**这串数字 (不要引号)。
# 2. 设置你的 GoToSocial Bearer Token 2. **设置 BIND_CODE 密钥**
# 这是用于 API 认证的访问令牌 * 在终端执行以下命令,当提示时,粘贴您刚刚复制的数字:
bun x wrangler secret put GOTOSOCIAL_TOKEN ```bash
``` bun x wrangler secret put BIND_CODE
```
3. **设置 GoToSocial 密钥**
* 执行以下命令来设置您的 GoToSocial 实例地址和访问令牌:
```bash
# 设置 GoToSocial 实例 API 地址
# 示例: https://your-domain.com/api/v1/statuses
bun x wrangler secret put GOTOSOCIAL_URL
# 设置 GoToSocial 访问令牌 (Bearer Token)
bun x wrangler secret put GOTOSOCIAL_TOKEN
```
### 4. (可选) 本地配置 ### 4. (可选) 本地配置
@@ -44,6 +56,7 @@ bun x wrangler secret put GOTOSOCIAL_TOKEN
- `GOTOSOCIAL_URL`: 你的 GoToSocial 实例 API 地址。 - `GOTOSOCIAL_URL`: 你的 GoToSocial 实例 API 地址。
- `GOTOSOCIAL_VISIBILITY`: 动态的可见性,默认为 `private`。可选值:`public`, `unlisted`, `private`, `direct`。 - `GOTOSOCIAL_VISIBILITY`: 动态的可见性,默认为 `private`。可选值:`public`, `unlisted`, `private`, `direct`。
- `BIND_CODE`: 您在WPS后台看到的 `bind_code`。
> **注意**: 在生产环境(部署后),配置的密钥 (`secrets`) 会覆盖 `wrangler.toml` 文件中的 `vars` 变量。 > **注意**: 在生产环境(部署后),配置的密钥 (`secrets`) 会覆盖 `wrangler.toml` 文件中的 `vars` 变量。
@@ -56,12 +69,13 @@ bun x wrangler deploy
部署成功后Cloudflare 会提供一个 Worker URL格式通常为 部署成功后Cloudflare 会提供一个 Worker URL格式通常为
`https://wps-gotosocial-bot.你的用户名.workers.dev` `https://wps-gotosocial-bot.你的用户名.workers.dev`
### 6. 配置 WPS 表单 ### 6. 绑定 WPS 表单
1. 打开你的 WPS 表单,进入 **设置 -> 数据推送** 1. 回到 WPS 表单的“数据推送”设置页面
2. 在 **URL** 输入框中,填入你部署好的 Worker URL并在末尾加上 `/webhook`。最终的 URL 应该像这样: 2. 在 **URL** 输入框中,填入你部署好的 Worker URL并在末尾加上 `/webhook`。最终的 URL 应该像这样:
``` ```
https://wps-gotosocial-bot.你的用户名.workers.dev/webhook https://wps-gotosocial-bot.你的用户名.workers.dev/webhook
``` ```
3. 点击 **“校验并绑定”** 3. 确保您已经通过 `wrangler secret put BIND_CODE` 设置好了密钥
4. 绑定成功后WPS 表单的任何新提交都将自动推送到你的 GoToSocial。 4. 点击 **“校验并绑定”**。如果一切顺利,会提示绑定成功。
5. 之后WPS 表单的任何新提交都将自动推送到你的 GoToSocial。

View File

@@ -6,6 +6,7 @@ compatibility_date = "2024-01-01"
# GOTOSOCIAL_URL: GoToSocial 实例的 API 地址 # GOTOSOCIAL_URL: GoToSocial 实例的 API 地址
# GOTOSOCIAL_TOKEN: GoToSocial 的 API Bearer Token # GOTOSOCIAL_TOKEN: GoToSocial 的 API Bearer Token
# GOTOSOCIAL_VISIBILITY: 可选, toot 的可见性, 默认 'private' (private, direct, unlisted, public) # GOTOSOCIAL_VISIBILITY: 可选, toot 的可见性, 默认 'private' (private, direct, unlisted, public)
# BIND_CODE = "paste-the-code-from-wps-ui-here"
# #
# 部署前, 请务必在 Cloudflare Dashboard 中设置好 GOTOSOCIAL_URL 和 GOTOSOCIAL_TOKEN 的 secrets # 部署前, 请务必在 Cloudflare Dashboard 中设置好 GOTOSOCIAL_URL 和 GOTOSOCIAL_TOKEN 的 secrets
# 例如: npx wrangler secret put GOTOSOCIAL_TOKEN # 例如: npx wrangler secret put GOTOSOCIAL_TOKEN