[保姆级] 2026 最新：1Panel 面板部署 Emby 开心版，打造私人影视库（全网最细避坑指南）

前言

拥有一台私人影音服务器是很多人的梦想，但对于新手来说，面对复杂的 Linux 命令行往往无从下手。即使使用了面板，也会遇到“第三方库失效”、“挂载路径混乱”、“服务器卡死”等各种坑。

本文将手把手教你利用 1Panel 面板，在国外高性价比 VPS（如 RackNerd）上，零代码基础 搭建一套完美的 Emby（解锁版） 影视系统。

这份教程总结了无数次试错后的唯一正确路径，重点解决了仓库 404 报错、缺少解压工具、中文刮削失败等常见痛点，只要照着做，100% 成功！

准备工作

• VPS 一台： 建议使用 Debian 11/12 或 Ubuntu 20.04/22.04 系统（本文以 2G-2.5G 内存机型为例）。
• 工具： SSH 连接工具（如 Termius, Xshell, 或 Windows 自带的 CMD）。

第一步：VPS 系统更新与环境初始化（必做）

⚠️ 这一步至关重要！ 很多教程只教你安装 curl，却忽略了 unzip，导致后续第三方库无法解压。请务必执行以下命令。

1. 使用 SSH 工具连接到你的 VPS。
2. 直接复制以下命令并回车（更新软件源并安装必要的解压工具）。

如果是 Debian/Ubuntu 系统：

apt update && apt upgrade -y
apt install curl wget sudo unzip -y

如果是 CentOS 系统：

yum update -y
yum install curl wget sudo unzip -y

(等待跑码结束，回到命令行光标状态即可进入下一步)

第二步：一键安装 1Panel 面板

1Panel 是目前最好用的国产服务器运维面板，可视化操作 Docker 容器非常方便。

1. 复制以下官方一键安装命令：

curl -sSL https://resource.fit2cloud.com/1panel/package/quick_start.sh -o quick_start.sh && bash quick_start.sh

2. 安装过程中的交互配置：

   • 设置安装目录：可以直接回车（默认）。
   • 设置端口：建议回车（默认）或自己设置。
   • 关键： 设置面板的用户名和密码，并截图或记下来。
3. 安装完成后，控制台会输出一个 http://IP:端口/安全入口 的地址。在浏览器打开它，登录面板。

第三步：配置第三方应用商店（核心避坑点）

1Panel 官方库里只有官方版 Emby（收费且受限）。我们需要配置第三方库来获取 Amilys 版 Emby（自带解锁 Premiere 功能）。

⚠️ 注意： 网上很多旧教程的仓库地址已失效（会报 404 错误），请务必使用下面这个修复了仓库名和分支的最新脚本。

1. 登录 1Panel 面板，点击左侧菜单 “计划任务”。
2. 点击 “创建计划任务”。
3. 执行周期： 选择 “手动执行”。
4. 脚本内容： 清空输入框，完整复制以下代码：

#!/bin/bash

# --- 配置部分 ---
# 使用 ghproxy 代理加速下载链接 (这是解决卡死的关键)
URL="https://ghproxy.net/https://github.com/okxlin/appstore/archive/refs/heads/localApps.zip"
# 1Panel 本地应用的默认路径 (通常不需要改)
APP_DIR="/opt/1panel/resource/apps/local"
# 临时下载路径
TEMP_FILE="/tmp/appstore_proxy.zip"

echo "=== 开始执行加速更新任务 ==="
echo "正在通过代理下载应用包..."

# 1. 下载文件 (增加了超时限制，避免无限卡死)
wget --no-check-certificate -O "$TEMP_FILE" "$URL"

# 2. 检查是否下载成功
if [ $? -eq 0 ] && [ -s "$TEMP_FILE" ]; then
    echo "下载成功！开始解压安装..."

    # 3. 解压到目标目录
    # -o 表示覆盖旧文件，-d 指定目录
    unzip -o "$TEMP_FILE" -d "$APP_DIR"
    
    # 4. 调整目录结构
    # 因为下载的 zip 解压后会多一层文件夹 (如 appstore-localApps)，需要移出来
    if [ -d "$APP_DIR/appstore-localApps" ]; then
        echo "正在调整文件结构..."
        cp -rf "$APP_DIR/appstore-localApps"/* "$APP_DIR/"
        rm -rf "$APP_DIR/appstore-localApps"
    fi

    # 5. 清理临时文件
    rm -f "$TEMP_FILE"
    
    echo "=== 更新完成！ ==="
    echo "请去【应用商店】刷新页面，点击顶部的【更新应用列表】即可看到效果。"
else
    echo "!!! 下载失败 !!!"
    echo "可能是代理节点波动，请稍后再次点击‘执行’重试。"
    exit 1
fi

5. 点击 “确认”，然后点击这行任务右侧的 “执行”。
6. 点击 “报告”，看到 🎉 恭喜！安装成功！ 字样后，进入下一步。

第四步：安装 Emby Server (Amilys版)

1. 点击左侧 “应用商店”。
2. 重要动作： 点击页面右上角的 “更新应用列表”（一定要点一下，否则刷不出来新应用）。
3. 搜索 Emby，你会看到两个版本。请选择左边图标带小人的 Amilys Emby Server，点击 “安装”。

⚠️ 关键配置（请严格照抄）

安装弹窗中，请按以下表格修改配置，这对后续体验至关重要：

4. 点击右下角的 “确认”。
5. 等待状态变为绿色的 “已启动”。

第五步：Emby 初始化向导（手把手图文复盘）

在浏览器输入：http://你的VPS公网IP:8096，即可进入设置向导。

1. 基础设置

• Preferred Language (首选语言): 下拉选择 Chinese Simplified (简体中文)。
• Create User (创建用户): 设置你的管理员用户名和密码。

2. 添加媒体库（最容易出错的地方）

点击中间的大加号 + New Library：

• Content type: 选 Movies (电影)。
• Display name: 填 电影。

• Folders (文件夹): 点击旁边的 + 号。

  • 重点来了： 在列表里，如果能直接看到 /media 就选它。
  • 如果看不到 /media，请点击 /mnt -> 然后选择 share1。
  • 原理：1Panel 的模板可能会自动把宿主机的 /home/media 映射为容器内的 /mnt/share1，这是正常的，选它没错。

• Library Settings (刮削设置):

  • 将 Language 和 Country 全部选为 Chinese / China。
  • 点击 OK 保存。

3. 优化元数据（为以后迁移做准备）

在点击 Next 之前，建议再次点击刚才建好的“电影”库图标，进行高级设置：

• 找到 Metadata Savers (元数据储存器)：✅ 勾选 Nfo。

• 找到 Movie Image Fetchers (图片设置)：✅ 开启开关 "Save artwork into media folders"。

  • 理由： 这会将电影的海报、简介直接保存在电影文件夹里。以后如果你迁移服务器，Emby 可以秒级恢复海报墙，无需重新下载。

4. 性能保命设置（VPS 用户必看）

• 继续向下滑，找到 Video Preview Thumbnails (视频预览缩略图)。

• 务必选择：Never (从不)。

  • 理由： 这个功能会像 YouTube 一样生成进度条预览图，会疯狂占用 CPU 和几十 GB 的硬盘空间。对于 2G 内存的 VPS 来说，开启它等于服务器死机。

5. 远程访问与完成

• 一路点击 Next。
• 在 Configure Remote Access 页面：确认 Allow remote connections (允许远程连接) 是 勾选 状态。
• 最后接受条款，点击 Finish。

结语

恭喜！当你看到黑绿色的 Emby 主页时，你的私人影音服务器就已经搭建完成了。

虽然现在里面是空的，但你已经打好了最坚实的基础。后续你只需要在 1Panel 应用商店安装 CloudDrive2 或 Alist，将网盘挂载到 VPS 的 /home/media 目录，你的 Emby 瞬间就能拥有海量的云端影视资源！

By 1024Bit - 2026