CSUBOT 是一个开源的超级管理员机器人。
本文介绍如何自行部署 CSUBOT 。
请先完整阅读这个文档： CSUBOT 机器人使用说明书
推荐： 查询本机访问不同网站的公网 IP ，用于检查当前网络环境。
前提条件
自行部署 CSUBOT ，需要至少满足如下条件：
- 持有域名。 (至少持有一个二级域名，用于后端。实际前端和后端一共需要两个域名，但一般前端域名可以由部署的平台提供)
- 持有一个服务器。或者部署在可以部署后端服务的平台上。如果您知道一个免费的，可以部署后端服务的平台，请不要犹豫， 点击这里，发布评论告诉作者 。
- 持有没有被限制的 Telegram 账户，用于创建 Telegram 机器人，并且获取机器人的 Token
- 持有没有被限制的 Cloudflare 账户，用于启用 Cloudflare Turnstile 验证码。注册账户： https://dash.cloudflare.com/
操作步骤
- 启用 Cloudflare Turnstile
- 部署前端
- 创建 Telegram 机器人
- 配置后端
启用 Cloudflare Turnstile
点击这个链接，打开 Cloudflare Turnstile 配置面板 Turnstile 组件配置
点击 add widget，添加一个 Turnstile 部件
点击 Add Hostnames ，添加前端的域名。如果您打算使用前端托管平台提供的域名，这里可以随便写。
点击创建按钮，然后就可以看到 Site Key 和 Secret Key
部署前端
我们以部署到前端托管平台为例。
- 打开 https://github.com/cjh0613/csubot-vue ， fork 这个仓库
- 选择部署的平台，如 Cloudflare Pages, Vercel, Netlify 等都可以。
- 选择由 Github 仓库导入，选择第一步中 fork 的仓库。
工作路径配置为项目根目录，编译命令是：
npm install && npm run build
输出的目录是：
dist/
配置环境变量：
VITE_ENDPOINT=https://xxxx.com <后端 URL，需要https>
VITE_SITEKEY=0x4AAAAAABBBBBBBBBBB <Cloudflare turnstile 的站点密钥 Site Key (位置靠上的那个)>
- 开始部署，完成之后就可以看到平台提供域名。您也可以绑定自己的域名。需要等待 DNS 配置和证书生成。
创建 Telegram 机器人
私聊 https://t.me/BotFather ，发送 /newbot ，根据机器人的提示创建新机器人，创建完成之后，您会收到一个 Token
配置后端
环境变量参考
TGWD_TOKEN=<Telegram 机器人的 token , @botfather 处获取>
TGWD_FRONTEND_DOMAIN=<前端域名，不需要https>
TGWD_SECRET=<随便填>
TGWD_PORT=8000
TGWD_CFTS_API_KEY=<Cloudflare turnstile 的 Secret Key 密钥(站点密钥下面的那个)>
使用二进制执行文件
我们以 linux amd64 操作系统为例。
首先创建一个新的文件夹。
mkdir csubot && cd csubot
下载二进制执行文件。这里的下载链接，请打开 https://github.com/cjh0613/csubot/releases 获取最新的链接，可能需要点击 Show all assets ，才能找到适合您的平台的文件。
wget https://github.com/cjh0613/csubot/releases/download/vxxx/csubot-linux-amd64.zip
因为是 zip 格式的压缩包，解压：
unzip csubot-linux-amd64.zip
如果无法执行这个命令，请确认成功安装 unzip 包。
进入 csubot 所在目录，
使用以下命令，可以查看到隐藏的 .env.example 文件。
ls -la
使用您的文本编辑器（如 nano, vim ），创建一个新的文件 .env ，参考示例文件 .env.example 进行配置。
尝试运行：
export $(grep -v '^#' .env | xargs) && ./csubot
自行编译
在项目根目录执行命令：
go build -o csubot
尝试运行：
export $(grep -v '^#' .env | xargs) && ./csubot
HTTPS
后端并未直接提供 https 的支持，仅可 http 访问。
您可以使用 Apache, Nginx, Microsoft Internet Information Services (IIS) 等服务配置 HTTPS 。
如果您使用 Cloudflare CDN ，也可以在 SSL/TLS encryption 将 encryption mode 设置为 Flexible 。这样用户访问 Cloudflare 服务器是使用的 Cloudflare 自动配置的 https 协议，然后 Cloudflare 访问您配置后端服务的服务器是采用的 http 协议。
本网页的其他版本
本文章有多种语言的版本。
如果您想发表评论，请访问以下网页：
这些网页仅支持浏览，无法发表评论或留言，但提供了更多语言选项，并且加载时间更短：
ZH EN ZH-TW JA RU KO CS ES AR FR PT DE TR IT NL SV DA FI PL UK HE RO HU EL HR TH HI BN ID SW VI NO
