InstallDoc

安装

docker方式安装

容器开放在 8018 端口，如有SSL需求请自行套上nginx等

快速安装（推荐）（利用脚本实现部署）

1. 下载、导入数据库。
   • 默认用户名/密码：admin/A123456
2. 使用脚本

wget https://raw.githubusercontent.com/RandallAnjie/EmbyController/refs/heads/main/quickstart.sh && chmod +x quickstart.sh && ./quickstart.sh

手动安装

1. 下载、导入数据库。
   • 默认用户名/密码：admin/A123456
2. 下载环境文件example.env并修改为.env，根据需要更新环境变量。
3. 拉取 ranjie/emby-controller:latest 将.env文件映射到容器内的/var/www/html/.env。

Crontab定时任务/webhook回调任务配置

Crontab定时任务

每天定时（推荐凌晨4点）访问: 【你的域名】/media/server/crontab?key=【此处填写你配置文件中的CRONTAB_KEY】

如： https://randallanjie.com/media/server/crontab?key=123

webhook回调任务

在emby后台通知界面新增通知，选择webhook

URL填写: 【你的域名】/api/Media/webhook?key=【此处填写你配置文件中的CRONTAB_KEY】

如：https://randallanjie.com/api/Media/webhook?key=123

请求内容类型选择 application/json

Events选中播放的全部

配置文件说明

系统相关

变量名	含义	默认值	可选值	注意事项
APP_DEBUG	系统是否处于DEBUG模式	true	true / false	生产环境还请设置成 false
APP_HOST	系统域名	https://randallanjie.com	任意字符串	请设置成协议+域名格式，并且后面不需要“/”
CRONTAB_KEY	webhook或者定时任务密钥	randallanjie	任意字符串

数据库相关

变量名	含义	默认值	可选值	注意事项
DB_TYPE	数据库类型	mysql	任意字符串	数据库相关信息，目前只测试了mysql，其他数据库不确定会遇到什么问题
DB_HOST	数据库主机地址	127.0.0.1	任意字符串	Docker用户请务必配置，该处127.0.0.1必然访问不到你的数据库
DB_NAME	数据库名称	randallanjie	任意字符串
DB_USER	数据库用户名	root	任意字符串
DB_PASS	数据库密码	root	任意字符串
DB_PORT	数据库端口	3306	任意端口号
DB_CHARSET	数据库字符集	utf8	任意字符串
CACHE_TYPE	缓存类型	file	file / redis	如果填写redis就得填写redis相关信息
REDIS_HOST	Redis主机地址	127.0.0.1	任意字符串	Docker用户请务必配置，该处127.0.0.1必然访问不到你的数据库
REDIS_PORT	Redis端口号	6379	任意端口号
REDIS_PASS	Redis密码		任意字符串
REDIS_DB	Redis存储库号	8	0~15数字

Emby相关

• EMBY_URLBASE Emby内网api连接地址
  • 地址URl要保证后面要有 /emby/，要保证管理系统能连接到该地址
  • 如： http://127.0.0.1:8096/emby/
• EMBY_APIKEY Emby API
  • 请用EMBY管理账号登陆EMBY，并且进入后台左侧 高级 - API 密钥 ，选择 新 API 密钥 ，生成新密钥后填入此处
  • 
• EMBY_ADMINUSERID Emby 管理员用户id
  • 请用EMBY管理账号登陆EMBY，并且进入后台左侧 用户 ，在右侧选择当前登陆的用户，复制地址栏中 userId 的部分
  • 
• EMBY_TEMPLATEUSERID Emby 开号模板用户id
  • 同上一步操作，选择一个模板用户，之后通过管理系统开的账号都会以此账号设置为模板，别忘了将这个用户设置为禁用
• EMBY_LINE_LIST 线路信息，给用户的线路，可以根据线路多少自行增删
  • 比如我只有一条给用户观看的线路，就填写：

    EMBY_LINE_LIST_0_NAME = 直连线路
    EMBY_LINE_LIST_0_URL = http://127.0.0.1:8096
    

  • 若是有多条给用户观看的线路，就填写：

    EMBY_LINE_LIST_0_NAME = 直连线路
    EMBY_LINE_LIST_0_URL = http://127.0.0.1:8096
    EMBY_LINE_LIST_1_NAME = 优化线路
    EMBY_LINE_LIST_1_URL = http://192.168.1.1:80
    EMBY_LINE_LIST_2_NAME = 优化线路2
    EMBY_LINE_LIST_2_URL = https://meida.emby.com:443
    

    要保证对应的 NAME 和 URL 要对应上，并且序号不能重复

邮件相关

变量名	含义	默认值	可选值	注意事项
MAIL_TYPE	邮件发送协议		smtp / smtps	smtps是加密的，smtp是不加密的，谷歌邮箱的话用smtps
MAIL_HOST	邮件发送主机		任意字符串	比如谷歌的是smtp.gmail.com
MAIL_PORT	邮件发送端口		任意端口号	587端口一般是不加密，465端口一般加密
MAIL_USER	邮件发送用户		任意字符串	登陆你邮箱用的用户名，大部分都是xxxx@xxx.com
MAIL_PASS	邮件发送密码		任意字符串	登陆你邮箱用的密码，QQ邮箱或者Gmail等需要申请授权码
MAIL_FROM_NAME	邮件发送名称		任意字符串	给用户展示的名字，可以设置为自己网站的名字
MAIL_FROM_EMAIL	邮件发送邮箱号		任意字符串	给用户展示的邮箱号，一般等同于MAIL_USER

支付相关

现阶段支付采用对接易支付

• PAY_URL API 接口地址
• PAY_MCHID 商户ID
• PAY_KEY 商户密钥 (MD5签名方式)
• AVAILABLE_PAYMENT 支持的付款方式
  • 请查阅对应易支付开发文档，填入其掉用值
  • 比如只有支付宝支付方式，就填写：

    AVAILABLE_PAYMENT_0 = alipay
    

  • 若是有多种支付方式，就填写：

    AVAILABLE_PAYMENT_0 = alipay
    AVAILABLE_PAYMENT_1 = wxpay
    AVAILABLE_PAYMENT_2 = qqpay
    AVAILABLE_PAYMENT_3 = bank
    

TG机器人相关

• TG_BOT_TOKEN TG机器人密钥，向@BotFather申请
• TG_BOT_ADMIN_ID 管理员TGid，可以向我的机器人@randallanjie_bot发送 /start 获取
  • 
• TG_BOT_GROUP_ID 群组id
• TG_BOT_GROUP_NOTIFY 是否允许机器人在群组中发通知消息

CloudFlare相关

前往 CloudFlare 后台，进入 Turnstile ，创建小组件2次，在主机名管理中，添加你管理站的玉米，小组件模式分别选择 非交互式 和 不可见

非交互式 无需点击，会显示的验证，用于登陆注册，三方签到等

• CLOUDFLARE_TURNSTILE_NONINTERACTIVE_SITEKEY 非交互式小组件站点密钥
• CLOUDFLARE_TURNSTILE_NONINTERACTIVE_SECRET 非交互式小组件密钥

不可见 不需要点击，不会显示验证，用于仪表盘页面签到等

• CLOUDFLARE_TURNSTILE_INVISIBLE_SITEKEY 不可见小组件站点密钥
• CLOUDFLARE_TURNSTILE_INVISIBLE_SECRET 不可见小组件密钥

讯飞AI相关

讯飞ai使用的是讯飞星火 Spark Lite，该ai借口限制QPS为2，所以可以多申请几个账号 如，单账号用法：

XFYUNLIST_28654731426_APPID =
XFYUNLIST_28654731426_APIKEY =
XFYUNLIST_28654731426_APISECRET =

如，多账号用法：

XFYUNLIST_28654731426_APPID =
XFYUNLIST_28654731426_APIKEY =
XFYUNLIST_28654731426_APISECRET =
XFYUNLIST_18223313226_APPID =
XFYUNLIST_18223313226_APIKEY =
XFYUNLIST_18223313226_APISECRET =