# 如何在 VPS 上运行 Telegram 机器人？

> 用 6 个步骤在 VPS 上 24/7 运行 Telegram 机器人：令牌保存在仅 root 可读的文件中，使用 Python venv，并以会自动重启的 systemd 服务运行。

- URL: https://jadekvm.com/zh/guides/how-to-run-a-telegram-bot-on-a-vps/
- 最后更新: 2026-11-16
- 发布者: JadeKVM (https://jadekvm.com)

以下说明如何在 Debian 13 或 Ubuntu 24.04 的 VPS 上全天候运行 Telegram 机器人，并支持自动重启。

**快速回答 — 如何在 VPS 上运行 Telegram 机器人？**

要在 VPS 上运行 Telegram 机器人，请创建一个机器人用户，将代码放在 /opt/bot 中并使用 Python venv，把令牌保存在仅 root 可读的文件中，然后添加一个设置了 Restart=always 的 systemd 服务。之后机器人会在任何崩溃后 5 秒重启，并在开机时启动。1 GB 的 **JadeKVM** Bead 套餐即可满足需要。

**简要概述**

- **长轮询不需要开放端口**；webhook 则需要 443、80、88 或 8443 上的 HTTPS。
- **令牌放在 EnvironmentFile 中**，权限为 600，绝不放在代码仓库里。
- **Restart=always** 让机器人在崩溃和重启后保持运行。
- **日志在 journal 中**：`journalctl -u tgbot -f` 可实时跟踪。

## 用 6 个步骤在 VPS 上运行 Telegram 机器人？

示例使用 Python；systemd 部分对 Node.js 或 Go 机器人同样适用。

1. **获取令牌** — 在 Telegram 中用 BotFather 创建机器人，并复制它提供的令牌。
2. **创建机器人用户** — 运行 sudo adduser --system --group --home /opt/bot tgbot。
3. **安装代码** — 将 bot.py 复制到 /opt/bot，创建 venv 并安装 python-telegram-bot。
4. **保存令牌** — 将 BOT_TOKEN 写入 /etc/tgbot.env，并将权限设为 600。
5. **添加服务** — 将设置了 Restart=always 的内容写入 /etc/systemd/system/tgbot.service。
6. **启动并查看** — 运行 sudo systemctl enable --now tgbot，并跟踪 journal。

## 机器人应使用哪种更新方式？

*为运行在 VPS 上的机器人比较 Telegram Bot API 的更新方式*

| 方式 | 开放端口 | 是否需要 HTTPS | 适合 |
| --- | --- | --- | --- |
| 长轮询（getUpdates） | 无 | 否 | 大多数机器人，设置最简单 |
| Webhook（setWebhook） | 443、80、88 或 8443 | 是 | 流量大，每秒更新很多 |
| 两者同时使用 | 不可能 | 不适用 | 设置了 webhook 时，API 会拒绝 getUpdates |

## 如何在虚拟环境中安装机器人代码？

**在 /opt/bot 中创建 venv，在其中安装库，并将该文件夹的所有者设为机器人用户。** venv 使机器人的软件包与系统 Python 分开。Debian 13 和 Ubuntu 24.04 会阻止向系统 Python 安装 pip 包，因此 venv 是最干净的做法。

*机器人用户、venv 和令牌文件*

```bash
sudo apt install -y python3-venv
sudo adduser --system --group --home /opt/bot tgbot
sudo python3 -m venv /opt/bot/venv
sudo /opt/bot/venv/bin/pip install python-telegram-bot
sudo cp bot.py /opt/bot/
sudo chown -R tgbot:tgbot /opt/bot
echo 'BOT_TOKEN=123456:replace-with-your-token' | sudo tee /etc/tgbot.env > /dev/null
sudo chmod 600 /etc/tgbot.env
```

## 如何让 Telegram 机器人自动重启？

**设置了 Restart=always 和 RestartSec=5 的 systemd 单元，会在机器人任何退出后将其重启。** systemd 在切换到 tgbot 用户之前，会以 root 身份读取令牌文件，因此机器人无需自己读取该文件即可看到 BOT_TOKEN。在代码中用 `os.environ['BOT_TOKEN']` 读取它。

修改该单元后，请运行 `sudo systemctl daemon-reload`，然后重启服务。

*/etc/systemd/system/tgbot.service*

```ini
[Unit]
Description=Telegram bot
After=network-online.target
Wants=network-online.target

[Service]
User=tgbot
WorkingDirectory=/opt/bot
EnvironmentFile=/etc/tgbot.env
ExecStart=/opt/bot/venv/bin/python /opt/bot/bot.py
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
```

## 2026 年 Telegram 机器人最好的 VPS 位置是哪里？

**选择离你的用户或机器人所调用的 API 最近的城市；对大多数机器人而言，差距很小。** JadeKVM 于 2026 年 11 月 16 日读取了 WonderNetwork 的公开 ping：新加坡距雅加达为 15 ms，距孟买为 55 ms；香港距台北为 14 ms。JadeKVM 页面上的延迟数据是 WonderNetwork 于 2026 年 11 月 16 日在其自有服务器之间测得的公开平均值；它们说明各城市在网络上的距离，并不承诺任何一台 JadeKVM 服务器的表现。

如果机器人要发送定时消息，请先按 [如何在亚洲 VPS 上设置时区](https://jadekvm.com/zh/guides/how-to-set-the-timezone-on-an-asia-vps/ "How do you set the timezone on an Asia VPS?")] 设置正确的时区。使用 webhook 的机器人还需要 [免费 SSL 证书](https://jadekvm.com/zh/guides/how-to-install-a-free-ssl-certificate-on-a-vps/ "How do you install a free SSL certificate on a VPS?")]。

## 机器人在 JadeKVM 服务器上不能做什么？

**它不能通过 25 端口发送邮件，并且必须遵守可接受使用规则。** 每台服务器均关闭出站 25 端口；请通过 465 或 587 端口的邮件服务商发送邮件。禁止垃圾信息和群发消息；在启动群发机器人之前，请阅读 [可接受使用政策](https://jadekvm.com/zh/acceptable-use/ "Acceptable Use Policy")]。Bead 提供 1 shared vCPU, 1 GB RAM, 20 GB NVMe, 1 TB a month，足以满足大多数机器人的需要。

## 关于在 VPS 上运行 Telegram 机器人的常见问题

### Telegram 机器人需要公网 IP 吗？

长轮询不需要：机器人主动连接 Telegram。webhook 则需要公网 HTTPS 地址，每台 JadeKVM 服务器都具备。

### Telegram 机器人需要多少内存？

Python 机器人通常占用不到 100 MB。1 GB 套餐还为一个小型数据库留有余地。

### 对于机器人，systemd 比 screen 或 tmux 更好吗？

是的。screen 无法在机器人崩溃后将其重启，也无法在开机时启动它；systemd 两者都能做到。

### Telegram 允许哪些 webhook 端口？

443、80、88 和 8443，如 Bot API 文档所列。

### 如何更新机器人代码？

复制新文件，然后运行 sudo systemctl restart tgbot。journal 会显示任何启动错误。

**结论**

- **一个 venv、一个仅 root 可读的令牌文件，以及一个设置了 Restart=always 的 systemd 单元**，即可让机器人全天候在线。
- 长轮询是最简单的选择；只有当流量需要时，才切换为 webhook。

## 来源

1. [Telegram Bot API](https://core.telegram.org/bots/api) — Telegram (read 2026-11-16)
2. [机器人：面向开发者的入门介绍](https://core.telegram.org/bots) — Telegram (read 2026-11-16)
3. [python-telegram-bot 文档](https://docs.python-telegram-bot.org/) — python-telegram-bot (read 2026-11-16)
4. [venv，虚拟环境的创建](https://docs.python.org/3/library/venv.html) — Python Software Foundation (read 2026-11-16)
5. [systemd.service(5) 手册页](https://www.freedesktop.org/software/systemd/man/latest/systemd.service.html) — freedesktop.org / systemd (read 2026-11-16)
6. [WonderNetwork：从新加坡的 ping](https://wondernetwork.com/pings/Singapore) — WonderNetwork (read 2026-11-16)

**为你的机器人在亚洲找个家** Bead 12 个月期限每月 $3.75，适合大多数机器人。 [在新加坡订购 Bead](https://jadekvm.com/app/checkout/?plan=bead&term=12m&location=sg-sin&from=how-to-run-a-telegram-bot-on-a-vps&lang=zh) · [查看所有套餐](https://jadekvm.com/zh/pricing/ "JadeKVM 服务器每月多少钱？")

---

JadeKVM: JadeKVM 在香港、东京和新加坡销售 Linux KVM VPS，支持加密货币支付，无需身份证件，并公布各城市到亚洲其他地区的实测延迟。5 款套餐内存从 1 GB 到 16 GB，三个城市价格相同；在 12 个月期限下，比 2026 年 11 月 16 日核对的一款可比的无 KYC 加密货币套餐至少低 25%。运营方为巴拿马的 DomaineGoat LLC。
