Stremio-nCore-Addon高级部署指南：Docker环境配置详解

项目概述

Stremio-nCore-Addon是一个为Stremio媒体中心提供nCore私有种子站点内容支持的插件。本文主要针对高级用户，介绍如何在Docker环境中进行专业级部署和配置。

Docker Compose部署方案

基础配置模板

以下是推荐的Docker Compose配置模板，包含了必要的服务定义和端口映射：

services:
  stremio-ncore-addon:
    image: detarkende/stremio-ncore-addon:0.8.0
    environment:
      - NCORE_USERNAME=您的nCore用户名
      - NCORE_PASSWORD=您的nCore密码
    ports:
      - target: 3000  # HTTP服务端口
        published: 3000
        protocol: tcp
      - target: 3443  # HTTPS服务端口
        published: 3443
        protocol: tcp
      - target: 42069 # 种子服务端口
        published: 42069
    volumes:
      - type: bind
        source: /media/share  # 本地存储路径
        target: /addon       # 容器内挂载点
    restart: unless-stopped

版本选择建议

重要警告：在项目达到V1稳定版之前，强烈建议不要使用latest标签。原因包括：

1. 次要版本升级可能需要手动调整环境变量或卷配置
2. 可能导致服务中断
3. 功能稳定性无法保证

建议始终明确指定版本号（如示例中的0.8.0），待项目发布V1正式版后再考虑自动更新策略。

环境变量详解

必需环境变量

变量名	说明	示例值
NCORE_USERNAME	nCore账户用户名	myusername
NCORE_PASSWORD	nCore账户密码	mypassword

可选环境变量

变量名	功能说明	默认值
PORT	HTTP服务端口号	3000
HTTPS_PORT	HTTPS服务端口号	3443
ADDON_DIR	插件工作目录	/addon
TORRENTS_DIR	种子文件存储目录	${ADDON_DIR}/torrents
DOWNLOADS_DIR	下载文件存储目录	${ADDON_DIR}/downloads
CONFIG_DIR	配置文件存储目录	${ADDON_DIR}/config
NCORE_URL	nCore网站URL（仅当官方URL变更且插件未更新时需要修改）	预设值
CINEMETA_URL	Cinemeta服务URL（仅当官方URL变更且插件未更新时需要修改）	预设值

专业建议：对于生产环境，建议将不同类型的文件存储在不同物理位置：

1. 使用独立磁盘存储下载文件（DOWNLOADS_DIR）
2. 将配置文件（CONFIG_DIR）放在高可靠性存储上
3. 种子文件（TORRENTS_DIR）可放在SSD上提高响应速度

网络端口配置

插件默认监听三个关键端口：

1. HTTP服务：默认3000端口，提供基础的HTTP访问能力
2. HTTPS服务：默认3443端口，支持SSL加密通信
   • 自动获取SSL证书：每小时从local-ip.medicmobile.org/keys更新
3. 种子服务：固定42069端口，用于种子文件的上传下载

反向代理配置建议

如果使用Nginx等反向代理：

1. 只需暴露HTTP端口（3000）
2. HTTPS终止应在反向代理层处理
3. 确保42069端口能被外部访问以维持种子健康度

本地专用模式

"Local only"模式专为内网使用设计，配置要点：

1. 必须暴露HTTPS端口（3443）
2. 可使用.local-ip.medicmobile.org域名自动获取SSL证书
3. 建议同时暴露HTTP端口作为备用访问方式

存储配置最佳实践

1. 卷挂载：确保/addon目录挂载到具有足够空间的存储
2. 权限设置：容器用户需要有挂载目录的读写权限
3. 备份策略：定期备份CONFIG_DIR目录，防止数据丢失

后续步骤

完成Docker部署后，需要在Stremio客户端中添加此插件服务。具体客户端配置方法请参考相关文档。

故障排查提示

1. 检查容器日志获取启动错误信息
2. 验证端口冲突情况（特别是3000和3443）
3. 确认nCore账户凭证正确且未被封禁
4. 检查存储卷挂载是否成功及权限是否正确

通过以上专业配置，您可以获得一个稳定、高效的Stremio-nCore-Addon运行环境，充分体验nCore私有种子站点的丰富资源。