130 lines
4.0 KiB
Markdown
130 lines
4.0 KiB
Markdown
# 几个坑
|
||
* Telegram Bot API 提供了两种方式， webhook 和 long polling，目前项目只支持 webhook 方式。
|
||
* webhook 方式必须要用HTTPS 也就是需要准备**个人域名**和**一个有效证书**
|
||
* 证书一定要单独域名证书(泛域名证书不能用)
|
||
|
||
|
||
|
||
# 原理/思路
|
||
TG创建bot，要起一个服务支持BOT的功能， 所以需要配置webhook 让tg 和服务器建立连接。webhook 需要有HTTPS的外网域名并且修改DNS指向你所配置的服务器IP，这样就能保证TG的请求可以顺利到达并且验证BOT。
|
||
在服务器内部如果如果是单BOT， 可以直接用nodje 配合 PM2 直接起服务,然后修改server.js端口号443。 如果服务器上有多个服务，那么就需要用反向代理，反代简单说就是一个服务+映射规则 (ngnix或者apache后者其他都可以) 侦听80或者443端口，如果有指定的映射请求， 就转发到内部映射的各个服务。
|
||
|
||
例如
|
||
```
|
||
aaa.domain.com <=> locahost:3001
|
||
bbb.domain.com <=> locahost:3002
|
||
domain.com/ccc <=> localhost:3003
|
||
```
|
||
|
||
|
||
|
||
# 步骤
|
||
1. 需要去tg 创建一个bot，会得到token 和bot的tgurl
|
||
2. BOT服务：
|
||
1. 服务器上clone 项目，安装node, npm install
|
||
2. 如果需要配置多个BOT, clone不同目录, server.js里修改配置port，和config.js
|
||
3. 安装PM2，在每个bot目录下 PM2 start server.js
|
||
4. ``` pm2 status``` 确认服务跑起来了
|
||
1. 如果没起来， 查log文件（见底部）
|
||
5. curl 检查本地连接, curl 检查远端连接， not found 就对了
|
||
3. 外部连接
|
||
1. 修改DNS，我是用cloudflare 把添加A record， 直接把静态IP 绑定
|
||
2. 绑定以后， 本地开个terminal, ping 刚添加域名，直到解析的IP是你绑定的，这步确保连接上是畅通的
|
||
4. apache2开启SSL和反代
|
||
1. 复制证书到任意位置
|
||
2. 运行底部命令
|
||
3. /etc/apache2/sites-available 下找到默认的.conf，或者自己建个conf也行
|
||
4. 修改底部配置信息
|
||
5. 保存重启 ```service apache2 restart```
|
||
5. 剩下的就是配置和检查webhook，这里面也有不少坑，在反代配置文件部分。。记不清了。。
|
||
6. 如果一切顺利 /help 会弹出目录
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
```
|
||
pm2 部分
|
||
|
||
tail -200 ~/.pm2/logs/server-error.log
|
||
tail -200 ~/.pm2/logs/server-out.log
|
||
|
||
curl "localhost:23333"
|
||
curl "domain:23333"
|
||
|
||
SSL+反代
|
||
|
||
sudo a2enmod ssl
|
||
sudo a2enmod proxy
|
||
sudo a2enmod proxy_balancer
|
||
sudo a2enmod proxy_http
|
||
|
||
|
||
/etc/apache2/sites-available/xxx.conf
|
||
|
||
<VirtualHost *:443>
|
||
SSLEngine on
|
||
SSLProtocol all
|
||
SSLCertificateFile {{CERT_DIR}}/{{domain.cer}}
|
||
SSLCertificateKeyFile {{CERT_DIR}}/{{domain.key}}
|
||
SSLCACertificateFile {{CERT_DIR}}/{{domain.ca.cer}}
|
||
|
||
ServerName {{domain}}
|
||
|
||
ProxyRequests Off
|
||
ProxyPreserveHost On
|
||
ProxyVia Full
|
||
|
||
<Proxy *>
|
||
Require all granted
|
||
</Proxy>
|
||
# 这里我用的是子目录映射方式。懒得再申请一个证书。。domain.com/ccc <=> localhost:3003
|
||
ProxyPass /{{bot1url}}/ http://127.0.0.1:23334/ # bot1
|
||
ProxyPassReverse /{{bot1url}}/ http://127.0.0.1:23334/ # bot1
|
||
ProxyPass /{{bot2url}}/ http://127.0.0.1:23333/ # bot2
|
||
ProxyPassReverse /{{bot2url}}/ http://127.0.0.1:23333/ # bot2
|
||
</VirtualHost>
|
||
|
||
|
||
something for verify and DEBUG
|
||
|
||
Apache command:
|
||
service apache2 restart
|
||
service apache2 stop
|
||
service apache2 status
|
||
service apache2 reload
|
||
tail -100 /var/log/apache2/error.log
|
||
|
||
|
||
验证一下SSL:
|
||
https://www.ssllabs.com/ssltest/analyze.html 确保Trusted和In trust store是绿的（反正我这两个绿的就TG就能找到的到）
|
||
|
||
SET webhook
|
||
|
||
curl -F "url=https://{{domain}}/{{bot1url}}/api/gdurl/tgbot" 'https://api.telegram.org/bot{{BOT_TOKEN}}/setWebhook'
|
||
|
||
delete webhook
|
||
curl -F "url=" https://api.telegram.org/bot{{BOT_TOKEN}}/setWebhook
|
||
|
||
|
||
check webhook
|
||
curl "https://api.telegram.org/bot{{BOT_TOKEN}}/getWebhookInfo"
|
||
|
||
|
||
|
||
```
|
||
|
||
|
||
|
||
|
||
|
||
# Reference Link
|
||
|
||
https://core.telegram.org/bots
|
||
|
||
https://core.telegram.org/bots/api
|
||
|
||
https://www.jianshu.com/p/ca804497afa0
|