liwei2633/gopeed Docker 镜像 - 轩辕镜像

Gopeed Docker 镜像文档

镜像概述和主要用途

Gopeed（全称 Go Speed）是一款基于 Golang + Flutter 开发的高速下载管理器，支持 HTTP、BitTorrent、Magnet 协议，具备跨平台特性。除基础下载功能外，Gopeed 还支持通过 API 集成或 扩展 开发实现功能定制，是一款高度可自定义的现代化下载工具。

核心功能和特性

• 多协议支持：兼容 HTTP、BitTorrent、Magnet 协议，满足多样化下载需求
• 跨平台运行：支持所有主流操作系统，通过 Docker 容器化部署可进一步简化跨环境使用
• 高度可扩展：支持通过 API 集成第三方系统或开发扩展插件，扩展功能边界
• Web 管理界面：提供直观的 Web UI，方便远程管理下载任务
• 数据持久化：支持下载文件和配置数据的持久化存储，确保容器重启后数据不丢失

使用场景和适用范围

• 个人用户：需要高效管理多协议下载任务的个人用户
• 开发者：需集成下载功能到自有系统，或通过扩展定制下载逻辑的开发场景
• 跨平台需求：需要在不同操作系统或设备间统一管理下载任务的场景
• 容器化部署：偏好通过 Docker 简化安装、隔离环境的用户或企业

使用方法和配置说明

基本部署

通过以下命令快速启动 Gopeed 容器：

bash
docker run --name gopeed -d -p 9999:9999 liwei2633/gopeed

目录挂载

挂载下载目录

将宿主机目录挂载到容器内下载目录，实现下载文件持久化：

bash
docker run --name gopeed -d -p 9999:9999 \
  -v /path/to/host/downloads:/app/Downloads \
  liwei2633/gopeed

说明：/path/to/host/downloads 替换为宿主机实际下载目录路径

挂载数据目录

挂载数据目录以持久化配置、任务记录等应用数据：

bash
docker run --name gopeed -d -p 9999:9999 \
  -v /path/to/host/downloads:/app/Downloads \
  -v /path/to/host/storage:/app/storage \
  liwei2633/gopeed

说明：/path/to/host/storage 替换为宿主机数据存储目录路径

用户权限配置

通过环境变量指定容器运行的用户 ID（PUID）和组 ID（PGID），避免权限问题：

bash
docker run --name gopeed -d -p 9999:9999 \
  -e PGID=100 \  # 容器组 ID
  -e PUID=1000 \ # 容器用户 ID
  -v /path/to/host/downloads:/app/Downloads \
  liwei2633/gopeed

身份验证配置

通过环境变量启用 Web 界面身份验证，增强安全性：

bash
docker run --name gopeed -d -p 9999:9999 \
  -e GOPEED_USERNAME="admin" \  # Web 登录用户名
  -e GOPEED_PASSWORD="123" \    # Web 登录密码
  -v /path/to/host/downloads:/app/Downloads \
  -v /path/to/host/storage:/app/storage \
  liwei2633/gopeed

Docker Compose 配置示例

创建 docker-compose.yml 文件，简化多参数部署：

yaml
version: '3'
services:
  gopeed:
    image: liwei2633/gopeed
    container_name: gopeed
    restart: always
    ports:
      - "9999:9999"
    volumes:
      - /path/to/host/downloads:/app/Downloads
      - /path/to/host/storage:/app/storage
    environment:
      - PGID=100
      - PUID=1000
      - GOPEED_USERNAME=admin
      - GOPEED_PASSWORD=your_secure_password

启动服务：

bash
docker-compose up -d

配置参数说明

访问方式

容器启动后，通过浏览器访问以下地址打开 Gopeed Web 管理界面：

http://localhost:9999

（若配置了身份验证，需输入 GOPEED_USERNAME 和 GOPEED_PASSWORD 登录）