# Telegram Panel - 多账户管理面板

基于 **WTelegramClient** 的 Telegram 多账户管理面板（.NET 8 / Blazor Server），用于批量管理账号、统计与管理频道/群组、执行批量任务。

## 社区

- TG 频道：https://t.me/zhanzhangck
- 站长交流群：https://t.me/vpsbbq

## 功能亮点

- **账号管理**：Session/压缩包导入、手机号登录（验证码/2FA）、分类、批量删除
- **频道/群组**：按账号维度管理、筛选、分类；支持查看详情/编辑/设置管理员/导出链接
- **同步**：一键同步账号“创建的频道/群组”到本地数据库（用于列表展示与批量操作）
- **批量任务**：批量邀请、批量设置管理员等支持后台静默执行（刷新页面不影响）

> “同步”到底同步什么：见 `docs/sync.md`

## 截图

> 仓库自带后台截图：`screenshot/`

<details>
<summary>点击展开/收起截图</summary>

<img src="screenshot/Dashboard.png" width="900" />
<img src="screenshot/account.png" width="900" />
<img src="screenshot/Create channel.png" width="900" />
<img src="screenshot/Import account.png" width="900" />

</details>

## 🐳 Docker 一键部署（推荐）

面向小白：**`git clone` → `docker compose up` → 浏览器打开 → 登录改密码 → 配置 ApiId/ApiHash**。

### 0) 环境要求

- Docker（Windows 推荐 Docker Desktop + WSL2；Linux 直接装 Docker Engine）

### 1) 启动

```bash
git clone <你的仓库地址>
cd Telegram-Panel
docker compose up -d --build
```

启动后访问：`http://localhost:5000`

### 2) 默认后台账号（首次登录）

- 用户名：`admin`
- 密码：`admin123`

登录后到「修改密码」页面改掉即可。

### 3) 必做配置：Telegram API 凭据

到 https://my.telegram.org/apps 获取 `api_id` / `api_hash`，然后在面板「系统设置」里保存。

### 4) 数据持久化（别乱删）

容器内所有持久化数据统一挂载到宿主机 `./docker-data`：

- 数据库：`./docker-data/telegram-panel.db`
- Sessions：`./docker-data/sessions/`
- 系统设置本地覆盖：`./docker-data/appsettings.local.json`
- 后台登录凭据文件：`./docker-data/admin_auth.json`

### 5) 更新升级（git pull + 重新构建）

```bash
git pull
docker compose up -d --build
```

## 🌐 反向代理一条龙（可选）

Blazor Server 需要 WebSocket（`/_blazor`），反代必须支持 `Upgrade`。

Nginx 示例（完整说明见 `docs/reverse-proxy.md`）：

```nginx
location / {
  proxy_pass http://127.0.0.1:5000;
  proxy_http_version 1.1;
  proxy_set_header Upgrade $http_upgrade;
  proxy_set_header Connection "Upgrade";
  proxy_set_header Host $host;
}
```

## 本地开发运行（可选）

```bash
dotnet run --project src/TelegramPanel.Web
```

## 详细文档

- `docs/README.md`（索引）
- `docs/import.md`（压缩包批量导入结构）
- `docs/sync.md`（同步说明 + 自动同步）
- `docs/reverse-proxy.md`（Nginx/Caddy 反代，含 WebSocket）
- `docs/api.md`（接口速查）
- `docs/database.md`（数据库/表结构说明）
- `docs/advanced.md`（配置项/数据目录/后台任务等）