meoacgx
d531c162d6
本次文档更新： - README 快速开始新增“本地开发运行（可选）”指令：dotnet run --project src/TelegramPanel.Web。 - README 功能概览补充：账号导入支持 Telethon/TData 压缩包。 - 安装部署文档改为 GHCR 远程镜像流程（.env + TP_IMAGE + compose pull/up），并补充常用运维命令。 - 更新升级文档改为双路径：面板内一键更新（Release 资产）+ Docker 镜像更新（compose pull/up），并保留源码构建路径说明。 - 账号导入文档升级为 Zip/TData 双格式指南，补充结构示例、2fa.txt 说明、TData 注意事项与 Docker 存储路径。 - 文档首页入口文字更新为“账号导入（Zip / TData）”，与实际能力保持一致。
2.5 KiB
2.5 KiB
安装部署
本文档用于把 Telegram Panel 跑起来（推荐 Docker 远程镜像）。
Docker 部署（推荐）
环境要求
- Docker（Windows 推荐 Docker Desktop + WSL2；Linux 直接安装 Docker Engine）
第一步：准备项目
git clone https://github.com/moeacgx/Telegram-Panel
cd Telegram-Panel
cp .env.example .env
第二步：选择镜像版本
默认是稳定版（无需改动）：
TP_IMAGE=ghcr.io/moeacgx/telegram-panel:latest
如果你要开发版，把 .env 里的 TP_IMAGE 改成：
TP_IMAGE=ghcr.io/moeacgx/telegram-panel:dev-latest
第三步：启动
docker compose pull
docker compose up -d
启动后访问：http://localhost:5000
默认后台账号（首次登录）
- 用户名：
admin - 密码：
admin123
登录后到「修改密码」页面改掉即可。
必做配置：Telegram API 凭据
到 https://my.telegram.org/apps 用任意一个 Telegram 账号申请一次 api_id / api_hash，然后在面板「系统设置」里保存即可。
说明：不需要每个账号都申请，全站共用这一对即可工作。
注意：api_hash是 32 位十六进制字符串（0-9a-f），请不要填 Token/用户名/URL 等其它值。
数据持久化（别乱删）
容器内所有持久化数据统一挂载到宿主机 ./docker-data：
- 数据库：
./docker-data/telegram-panel.db - Sessions：
./docker-data/sessions/ - 系统设置本地覆盖：
./docker-data/appsettings.local.json - 后台登录凭据文件：
./docker-data/admin_auth.json
更多说明见：配置与数据目录。
常用命令
# 查看日志
docker compose logs -f
# 更新到当前 .env 指定的镜像版本
docker compose pull
docker compose up -d
# 重启 / 停止
docker compose restart
docker compose down
生产部署入口
- 反向代理（含 WebSocket）：见 反向代理
- Bot Webhook（可选，生产推荐）：见 Bot Webhook
更新与常见问题
下一步
- 账号导入：见 账号导入（Zip / TData）
- 新号必看：见 防冻结指南
- 列表/批量能力依赖同步：见 同步说明
本地开发运行（可选）
dotnet run --project src/TelegramPanel.Web