Sign inSign up

instituteiptv/iptv-management-system

By instituteiptv

•Updated 9 months ago

Image
8

5.2K

instituteiptv/iptv-management-system repository overview

Docker Pulls Docker Image Size License Platform Telegram

⁠IPTV 管理系统使用说明

本系统基于 FastAPI + Docker + 多架构镜像,支持用户注册 / 邀请码 / 审核 / IPTV 订阅管理,适合自建 IPTV 订阅服务。


⁠一、环境要求

  • Docker >= 20.10
  • Docker Buildx 已启用
  • 可访问 Docker Hub(用于拉取 / 推送镜像)

⁠二、快速启动(推荐)

⁠1️⃣ 拉取镜像
docker pull instituteiptv/iptv-management-system:latest

⁠2️⃣ 启动容器
docker run -d \
  --name iptv \
  -p 8080:8080 \
  -v $(pwd)/data:/data \
  -e ADMIN_USER=admin \
  -e ADMIN_PASS=admin \
  -e SESSION_SECRET=请填写hex32位随机字符串 \
  -e REGISTER_REQUIRE_INVITE=1 \
  -e REGISTER_REQUIRE_APPROVAL=1 \
  -e AUTO_FETCH_INTERVAL_MIN=30 \
  instituteiptv/iptv-management-system:latest

⁠3️⃣ 访问地址
用户主页:http://服务器IP:8080/
管理员后台:http://服务器IP:8080/admin.html

⁠三、环境变量说明

ADMIN_USER                 管理员用户名
ADMIN_PASS                 管理员密码
SESSION_SECRET             会话密钥(32字节随机 hex)
REGISTER_REQUIRE_INVITE    是否需要邀请码注册(1=是 0=否)
REGISTER_REQUIRE_APPROVAL  是否需要管理员审核(1=是 0=否)
AUTO_FETCH_INTERVAL_MIN    远程订阅自动拉取间隔(分钟)

⁠四、用户注册说明

⁠1️⃣ 注册规则
- 用户名:3-32 位,字母/数字/下划线
- 密码:最少 6 位
- 邀请码:若系统开启邀请码则必须填写

⁠2️⃣ 常见注册错误
INVITE_REQUIRED        需要邀请码
INVITE_USED_UP         邀请码已用完
PASSWORD_TOO_SHORT     密码太短
ACCOUNT_PENDING_APPROVAL  等待管理员审核
ACCOUNT_BANNED         账号被封禁

⁠五、管理员后台功能

- 用户审核 / 分组 / 封禁 / 解封
- 邀请码管理(次数 / 默认组 / 是否审核)
- IPTV 源管理(本地上传 / 远程拉取)
- 并发控制(Token / IP / 全站)
- 在线用户与访问统计

⁠六、订阅地址说明

⁠用户订阅链接格式
http://服务器IP:8080/sub.php?user=用户Token

支持标准 .m3u 播放器(PotPlayer / IPTV / VLC 等)


⁠七、数据目录说明

/data
 ├─ accounts.json      用户数据
 ├─ sources/           IPTV 源文件
 ├─ invites.json       邀请码
 ├─ stats.json         访问统计
 ├─ leases.json        并发租约
 └─ bans.json          Token 封禁记录

⁠八、安全建议(强烈建议)

1. 修改默认管理员账号密码
2. SESSION_SECRET 使用随机 32 位 hex
3. 后端端口建议只对可信网络开放
4. 定期备份 /data 目录

⁠九、问题排查

- 端口无法访问:检查防火墙 / 云厂商安全组
- 镜像拉取慢:使用国内镜像源
- 注册失败:查看页面错误提示或容器日志

查看日志:

docker logs -f iptv

⁠十、许可证

仅限学习 / 自建使用,请遵守当地法律法规

Tag summary

Content type

Image

Digest

sha256:236723be5…

Size

75.7 MB

Last updated

9 months ago

docker pull instituteiptv/iptv-management-system