使用宝塔面板部署 MediaGo：Docker 应用商店一键安装与服务端口详解

发布时间：2026/9/25 3:05:50来源：尧图网络

音视频桌面应用后端【免费下载链接】mediago跨平台视频提取工具支持流媒体下载、视频下载、m3u8 下载及 B站视频下载提供 Windows 和 Mac 桌面客户端。Cross-platform video extraction tool: Supports streaming download, video download, m3u8 download, and Bilibili video download, with desktop clients for Windows and Mac.项目地址https://gitcode.com/caorushizi/mediago点击查看免费下载MediaGo 是一个跨平台视频提取工具支持流媒体下载、M3U8 下载及 B 站视频下载并提供 Windows / Mac 桌面客户端。本文以官方文档 docs/jp/bt-install.md对应中文版 docs/bt-install.md为核心完整讲解如何通过宝塔面板的 Docker 应用商店在 Linux 服务器上部署 MediaGo并结合仓库中的 Dockerfile 与 docker/docker-entrypoint.sh 说明镜像内部的构建分层、启动参数与数据目录布局帮助读者在部署完成后能独立理解并排查服务行为。前提条件在开始部署前需要满足文档中明确的两个前提宝塔面板版本要求仅适用于宝塔面板 9.2.0 及以上版本安装宝塔面板前往宝塔面板官网选择正式版脚本下载安装旧版本面板没有 Docker 应用商店能力无法走本文流程。部署目标是一台可以安装 Docker 的 Linux 服务器。宝塔面板的 Docker 模块会自动处理 Docker 与 Docker Compose 的安装无需手动准备容器环境。部署步骤整个部署过程在宝塔面板图形界面中完成共四步。第一步进入 Docker 模块登录宝塔面板在左侧菜单栏中点击Docker如上图所示。第二步安装 Docker 与 Docker Compose首次进入Docker模块时面板会提示需要安装Docker和Docker Compose服务。点击立即安装即可如果服务器上已经装好这两项服务则该提示不会出现直接跳过这一步。这一步的必要性在于MediaGo 在宝塔应用商店中是一个基于 Docker Compose 的应用面板需要这两个组件来拉起和管理容器。第三步在应用商店中安装 MediaGoDocker 安装完成后进入Docker - 应用商店在应用列表中搜索并找到MediaGo点击安装。安装时需要关注两个关键选项与文档一致端口8899—— 这是 MediaGo 的 Web 控制台监听端口版本选择v3.0.0—— 当前应用商店提供的版本号。第四步等待应用初始化点击提交后面板会自动执行应用初始化拉取镜像、创建容器、绑定端口与数据卷文档说明大约需要13 分钟。初始化完成后即可通过浏览器访问。访问 MediaGo初始化完成后在浏览器地址栏中输入http://宝塔面板IP:8899即可打开 MediaGo 控制台开始添加下载任务、管理配置。如果无法访问优先检查两件事服务器防火墙 / 云平台安全组是否放行了 8899 端口面板中的应用状态是否显示为运行中。镜像内部结构三阶段构建上面的操作对应的是应用商店里预构建的镜像。从仓库根目录的 Dockerfile 可以看到该镜像采用三阶段multi-stage构建阶段一Node 构建器node:24.14.0-bookworm-slim通过 corepack 激活pnpm11.23.0先只拷贝各工作区的package.json再执行pnpm install --frozen-lockfile充分利用构建缓存构建player-ui播放器界面后续会被嵌入 Go 核心二进制以APP_TARGETserver模式构建服务端 Web UI按TARGETARCH下载对应平台linux-x64 / linux-arm64 等的第三方下载工具二进制供运行阶段使用。阶段二Go 构建器golang:1.25-bookworm编译apps/core核心服务关键命令为CGO_ENABLED0 GOOSlinux GOARCH${TARGETARCH} \ go build -trimpath -ldflags-s -w -o /out/mediago-core ./cmd/server关闭 CGO 并做静态链接使得产物可以直接运行在精简的 Debian 镜像上。同时把阶段一产出的player-ui/dist与apps/ui/build/server分别拷贝到apps/core/assets/player与apps/core/assets/web通过 Go 的go:embed机制打进同一个核心二进制。阶段三运行时debian:bookworm-slim关键指令如下摘自 DockerfileWORKDIR /app COPY --fromgo-builder /out/mediago-core /usr/local/bin/mediago-core COPY --fromnode-builder /src/.deps/linux-* /app/deps-tmp/ # 第三方工具 RUN mkdir -p /app/mediago/data /app/mediago/logs /app/mediago/downloads COPY docker/docker-entrypoint.sh /usr/local/bin/docker-entrypoint.sh EXPOSE 8899 VOLUME [/app/mediago] ENTRYPOINT [/usr/local/bin/docker-entrypoint.sh]几个值得注意的点EXPOSE 8899与宝塔应用商店中端口8899的默认值对应VOLUME [/app/mediago]声明了整个数据目录为数据卷这也是面板初始化时会自动创建持久化存储的原因——数据库、配置、下载文件在容器重建后不会丢失最终运行阶段没有安装 Node 与 Go 工具链只有ca-certificates和libicu72两个基础依赖镜像保持精简。启动参数解析entrypoint 与命令行标志宝塔面板最终是通过 docker/docker-entrypoint.sh 启动服务的。该脚本的核心内容exec mediago-core \ --port8899 \ --enable-auth \ --db-path/app/mediago/data/mediago.db \ --config-dir/app/mediago/data \ --log-dir/app/mediago/logs \ --local-dir/app/mediago/downloads \ --deps-dir/app/deps \ $脚本注释中解释了exec的作用用mediago-core直接替换 shell 进程使docker stop发出的 SIGTERM 能直达 Go 进程避免中间 shell 吞掉信号末尾的$则允许调用方在启动时追加参数覆盖默认值。这些标志在 apps/core/cmd/server/main.go 中通过flag.FlagSet注册含义与上表一一对应参数作用宝塔部署中的取值--port服务监听端口8899--enable-auth启用 API Key 鉴权开启--db-pathSQLite 数据库文件路径/app/mediago/data/mediago.db--config-dir持久化配置目录/app/mediago/data--log-dir日志目录/app/mediago/logs--local-dir默认下载目录/app/mediago/downloads--deps-dir下载器工具二进制目录/app/deps需要注意默认值在未传参数时apps/core/internal/app/config.go 中DefaultConfig()返回的默认端口是8080、监听地址为0.0.0.0、最大并发下载任务数MaxRunner为 2。也就是说entrypoint 显式把端口改成了 8899——这正是宝塔应用商店端口选项与文档中http://宝塔面板IP:8899访问地址的来源直接裸跑mediago-core而不带参数则会监听 8080。此外ApplyEnvAndDefaults()config.go还支持通过环境变量覆盖部分配置如PORT、DB_PATH、HOST、GIN_MODE、MEDIAGO_DEPS_DIR并支持MEDIAGO_RUNTIME_ROOT一次性约定data/logs/downloads三个子目录布局——与 Dockerfile 中mkdir -p /app/mediago/{data,logs,downloads}的目录结构是一致的。数据目录布局与持久化结合 Dockerfile 与 entrypoint 参数容器内的数据布局为/app/mediago/ ├── data/ # SQLite 数据库 (mediago.db) 持久化配置 ├── logs/ # 运行日志 └── downloads/ # 默认下载输出目录这三个目录都在VOLUME [/app/mediago]覆盖范围内。在宝塔面板部署时该卷由面板托管应用初始化、镜像升级或容器重建后数据仍然保留。排查问题时可以关注/app/mediago/logs下的日志文件下载产物的位置则以--local-dir指向的/app/mediago/downloads为准任务中也可指定其他目录。与本地 Docker 部署的对照除了宝塔应用商店同一镜像也可以在自有环境中直接部署。仓库根目录提供了 docker-compose.yml 作为本地构建调试参考services: mediago: build: context: .. dockerfile: mediago/Dockerfile ports: - 8899:8899 volumes: - mediago-data:/app/data - mediago-logs:/app/logs restart: unless-stopped它同样把容器内 8899 端口映射到宿主机验证了 8899 是 MediaGo 服务端的约定端口。正式服务器上则更推荐使用应用商店或已有镜像配合docker run的方式并通过挂载数据卷持久化/app/mediago。小结前提宝塔面板 9.2.0部署Docker模块 → 安装 Docker / Docker Compose →Docker - 应用商店安装MediaGo端口 8899、版本 v3.0.0→ 等待 13 分钟初始化访问http://宝塔面板IP:8899原理镜像为三阶段构建的静态 Go 服务entrypoint 以--port8899 --enable-auth等参数启动数据全部落在持久化卷/app/mediago的data/logs/downloads三个子目录中。按以上步骤完成部署后你就获得了一个带鉴权、数据可持久化的服务端 MediaGo 实例可以直接通过 Web 控制台或 API 管理下载任务。赞分享音视频桌面应用后端【免费下载链接】mediago跨平台视频提取工具支持流媒体下载、视频下载、m3u8 下载及 B站视频下载提供 Windows 和 Mac 桌面客户端。Cross-platform video extraction tool: Supports streaming download, video download, m3u8 download, and Bilibili video download, with desktop clients for Windows and Mac.项目地址https://gitcode.com/caorushizi/mediago点击查看免费下载相关推荐STORM 使用指南丢一个主题自动完成联网调研并生成带引用的完整报告STORM 使用指南丢一个主题自动完成联网调研并生成带引用的完整报告 STORMknowledge storm是一个 LLM 驱动的知识整理系统你给一音视频桌面应用后端基于宝塔面板aaPanelDocker 应用商店一键部署 Apollo 配置中心基于宝塔面板aaPanelDocker 应用商店一键部署 Apollo 配置中心本文介绍如何通过宝塔面板的 Docker 应用商店以一键安装的方式在服务配置中心后端微服务宝塔面板部署 New APIDocker 应用商店与 Compose 两种安装方式实战指南宝塔面板部署 New APIDocker 应用商店与 Compose 两种安装方式实战指南本文是 New API 在宝塔面板环境下的完整部署教程覆盖从宝塔后端API网关LLM 网关大模型上一篇backtesting.py5分钟跑通你的第一条量化回测曲线下一篇ice.js 微前端实战指南基于 ice/plugin-icestark 的框架应用与微应用接入创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

网站建设高端定制企业官网