Telegram 频道展示 项目完整部署指南
date
Nov 11, 2025
slug
example-052
status
Published
tags
技术教程
summary
这是一个基于 Node.js + Express 的 Telegram 频道内容展示网站，可以将任意公开的 Telegram 频道内容以博客形式展示在网页上。
type
Post
网址
category
URL
技术栈
- 后端: Node.js + Express
- 前端: 原生 HTML/CSS/JavaScript
- 代理: Nginx 反向代理
- API: Telegram Bot API
- 部署: PM2 进程管理
项目结构
text
文件配置详解
1. package.json
json
2. .env 环境变量配置
env
重要配置说明:
BOT_TOKEN: 在 Telegram 中通过 @BotFather 创建机器人获取
CHANNEL_ID: 将机器人添加为频道管理员后，通过 API 获取（通常是 -100 开头的数字）
3. server.js - 主服务器文件
javascript
4. public/index.html - 前端主页面
html
5. public/style.css - 样式文件
css
6. public/app.js - 前端逻辑
javascript
完整部署步骤
1. 服务器环境准备
bash
2. 项目部署
bash
3. 配置 Nginx 反向代理
bash
配置文件内容：
nginx
启用配置：
bash
4. 使用 PM2 管理进程
bash
5. 防火墙配置
bash
功能特性
✅ 自动缓存机制 - 5分钟缓存减少 API 调用
✅ 双主题支持 - 暗黑/浅色模式一键切换
✅ 响应式设计 - 完美支持桌面和移动端
✅ 实时刷新 - 手动刷新获取最新内容
✅ 错误处理 - 完善的错误提示和重试机制
✅ 健康检查 - 内置服务状态监控接口
✅ 性能优化 - 静态资源缓存和压缩
故障排除
常见问题解决
- 端口占用问题
bash
- Nginx 配置错误
bash
- 应用启动失败
bash
- API 获取失败
- 检查 Bot Token 和 Channel ID 是否正确
- 确认机器人已添加为频道管理员
- 验证频道是否为公开频道
维护命令
bash