LinkEmby公益服搭建与配置详解

December 6, 2025

LinkEmby 是一款基于 Next.js 框架开发的专业级 Emby 订阅管理系统。它通过分离的用户门户与管理员后台界面，高效地整合了订阅管理、用户运维及服务配置等一系列流程，旨在简化 Emby 服务器的商业化或多人共享运营工作。

您可以通过以下体验地址预览系统（管理员账号：admin，密码：password123）： https://demo.linkemby.com

系统安装与配置

如果您希望快速部署，可以通过执行以下一键安装脚本完成。只需连接至您的服务器 SSH 终端并运行下方命令：

curl -fsSL https://raw.githubusercontent.com/linkemby/linkemby-deploy/main/install.sh | bash

由于一键安装流程较为简单，在此不做赘述。下文将重点介绍如何使用 docker-compose.yml 模板进行更具可控性的部署。

首先，您需要获取部署所需的模板文件，包括 docker-compose.yml 和示例环境配置文件 .env.example：

接下来，在您的服务器上创建一个名为 linkemby 的目录，并将下载好的两个文件放入其中。

打开 .env.example 文件，开始检查和修改必要的配置项。

为了加速国内环境的拉取过程，您可以将 GH_PROXY、DOCKER_PROXY 和 GHCR_PROXY 这三个参数修改为可用的国内镜像代理地址。

根据您的端口规划，可以调整 POSTGRES_PORT、REDIS_PORT 和 LINKEMBY_PORT 这三个对外暴露的端口号。

注意：配置文件中下方对应的内部连接端口（如 POSTGRES_HOST_PORT）通常无需修改，仅用于容器间通信。

NEXTAUTH_URL 是关键配置，需修改为您当前服务器的 IP 地址（如果您拥有公网域名并配置了反向代理，则应填写域名地址）。

NEXTAUTH_SECRET、ENCRYPTION_KEY、ENCRYPTION_IV 和 CRON_SECRET 这几项是用于系统加密的密钥。您需要按照注释要求，生成对应长度的随机字符串填入。

其余配置项可暂时保持默认，完成修改后保存文件。

将文件名从 .env.example 重命名为 .env。

在您的 Docker 管理工具（如 Portainer）中创建新项目，选择之前创建的 linkemby 目录，系统将自动导入其中的 docker-compose.yml 模板。

部署时可能会遇到文件权限问题。如果出现此类情况，请先停止项目，然后在服务器终端对 linkemby 目录执行权限修改命令：

sudo chmod -R 777 /path/to/your/linkemby

请将 /path/to/your/linkemby 替换为您的实际目录路径。

基本功能使用指南

部署完成后，在浏览器地址栏输入 http://您的服务器IP:3000 即可访问 LinkEmby 前端界面（端口号 3000 对应您配置的 LINKEMBY_PORT）。

首次使用时需要注册一个管理员账户。

按照页面提示填写账号、邮箱及密码等信息。

注册成功后，使用刚刚创建的账号密码进行登录。

管理面板功能丰富，以下将简要介绍核心的使用流程。

提示：在未激活授权的情况下，系统最多支持管理10个用户和1台Emby服务器，且部分高级功能受限（如需激活授权，可咨询项目开发者）。

首先，需要添加您的 Emby 服务器。在侧边栏找到“服务器管理”并点击“添加服务器”。

提示：所需的“API 密钥”需要在您的 Emby 服务器后台控制台中获取。

在添加页面，填写 Emby 服务器的地址、端口以及刚才获取的 API 密钥。

保存之前，务必点击“测试连接”按钮以确保信息填写正确且网络通畅。

连接测试成功后，保存设置，服务器便添加完毕。

接下来进入“用户管理”页面，点击“创建用户”（或使用“邀请用户”功能）。

按要求填写测试用户的用户名、密码等信息，可以为其预分配一些账户余额。

然后，转到“订阅管理”部分，创建一个新的订阅计划。

填写该订阅计划的基本信息，如名称、描述等。

设置订阅价格（此项为可选，可以设置为免费）。

可以设置该计划允许的试用天数。

如果有多台Emby服务器，可以在此配置负载均衡策略，单台服务器则无需设置。

关键步骤是关联此订阅计划到具体的 Emby 服务器，并选择一个“模板用户”。LinkEmby 将以此模板用户的权限在 Emby 中为新订阅者创建账户。

保存后，一个可供用户购买的订阅收费计划就创建完成了（具体的支付网关配置较为复杂，本文不做展开）。

完成以上基本设置后，测试用户即可登录其“用户中心”门户网站，自行浏览和选择订阅计划。

用户点击购买订阅后，流程将引导其完成后续操作，步骤直观，此处不再赘述。

管理员也可以直接在后台为用户分配订阅。回到“用户管理”，找到之前创建的测试用户并点击“编辑”。

在编辑页面中，找到订阅信息设置项，为该用户选择刚刚创建的订阅计划。

保存后，该用户的订阅状态即被更新（若页面未即时显示，可尝试刷新浏览器）。

此时，登录到您的 Emby 服务器管理后台，在用户列表中应当能看到 LinkEmby 系统自动创建的对应用户。

最后，使用测试用户的账号和密码，即可成功登录 Emby 服务器享受媒体服务。

功能扩展提示： LinkEmby 还集成了众多高级管理功能，限于篇幅无法逐一详解，以下仅作概览，有兴趣的用户可在部署后深入探索：

支付管理：集成多种支付渠道。
订单管理：查看和处理所有订阅订单。
优惠码管理：创建和管理促销折扣码。
卡密管理：实现卡密自助充值（需授权激活）。
邀请管理：设置用户邀请奖励机制。
工单管理：为用户提供技术支持通道。
文档管理：发布和管理帮助文档。
公告管理：向用户发布系统公告。
点播管理：可能用于管理单独计费的影片（需授权激活）。
定时任务：管理系统后台的自动执行任务。
系统设置：配置站点基础信息、邮件服务器等。
授权管理：查看和管理系统授权状态。

总结与评价

LinkEmby 作为一款功能全面的 Emby 订阅管理解决方案，其界面设计友好，集用户管理、订阅计划、支付集成、工单系统等核心模块于一体，非常适合有意将个人 Emby 服务进行商业化运营或希望规范化管理多人共享的小型团队。需要注意的是，在未购买授权的情况下，系统存在用户数、服务器数量限制，且部分高级功能无法使用。尽管如此，其提供的基础功能已足够满足初步测试与轻量级运营需求。目前市面上同类开源管理面板较少，对于有此特定需求的用户而言，LinkEmby 值得部署尝试。

综合推荐指数：⭐⭐⭐（面向特定小众需求） 使用体验评价：⭐⭐⭐（功能强大，部分高级功能需授权解锁） 部署难度评估：⭐⭐⭐（流程清晰，具备基础 Docker 知识即可完成）