基于htpcBeginner/docker-traefik的Synology DS918+ Docker部署指南

环境概述

本文介绍如何在Synology DS918+ NAS设备上使用Docker Compose部署一套完整的媒体服务和管理系统。该部署方案源自htpcBeginner/docker-traefik项目，是一个经过优化的家庭媒体中心解决方案。

系统要求

• Synology DS918+ NAS设备
• Docker版本20.10.23或更高
• Docker Compose版本v2.23.3或更高
• 已配置好的网络环境

网络配置详解

该部署方案使用了多种网络模式，以满足不同服务的网络需求：

1. 默认桥接网络

default:
  driver: bridge

这是Docker的默认网络模式，为容器提供基本的网络连接能力。

2. 自定义桥接网络

socket_proxy:
  name: socket_proxy
  driver: bridge
  ipam:
    config:
      - subnet: 192.168.91.0/24

t2_proxy:
  name: t2_proxy
  driver: bridge
  ipam:
    config:
      - subnet: 192.168.90.0/24

这两个自定义桥接网络为特定服务提供隔离的网络环境，可以自定义子网地址。

3. Macvlan网络

dockervlan:
  name: dockervlan
  driver: macvlan
  driver_opts:
    parent: eth1
  ipam:
    config:
      - subnet: "192.168.1.0/24"
        ip_range: "192.168.1.25/32"
        gateway: "192.168.1.1"

Macvlan网络允许容器直接使用物理网络接口，获得独立的IP地址，这对于需要直接暴露在局域网中的服务非常有用。

安全配置

该部署方案采用了Docker Secrets来管理敏感信息：

secrets:
  basic_auth_credentials:
    file: $DOCKERDIR/secrets/basic_auth_credentials
  cf_dns_api_token:
    file: $DOCKERDIR/secrets/cf_dns_api_token
  traefik_forward_auth:
    file: $DOCKERDIR/secrets/traefik_forward_auth
  mysql_root_password:
    file: $DOCKERDIR/secrets/mysql_root_password
  plex_claim:
    file: $DOCKERDIR/secrets/plex_claim

这种配置方式避免了将敏感信息直接写入配置文件，提高了安全性。

服务组件

该部署方案包含多个服务组件，通过include指令组织：

核心服务

• Traefik: 反向代理和负载均衡
• Socket Proxy: Docker socket代理，增强安全性
• OAuth: 认证服务
• Portainer: Docker管理界面

网络服务

• ZeroTier: 虚拟局域网服务

媒体服务

• Plex: 媒体服务器
• Plex Sync: Plex媒体同步工具
• Tdarr: 媒体转码和优化工具

文件管理

• Syncthing: 文件同步工具
• VSCode: 基于浏览器的代码编辑器

监控服务

• Glances: 系统监控工具

维护工具

• Docker GC: Docker垃圾回收
• DDNS Updater: 动态DNS更新工具

部署建议

1. 网络规划：根据实际网络环境调整子网配置，避免IP地址冲突
2. 安全配置：确保所有敏感信息都通过secrets管理
3. 服务选择：可以根据实际需求注释掉不需要的服务
4. 性能考量：Synology DS918+资源有限，建议根据实际负载调整服务配置

常见问题解决

1. 网络问题：如果容器无法联网，检查macvlan的parent接口是否正确
2. 权限问题：确保Docker有足够的权限访问配置文件和secrets
3. 资源限制：监控系统资源使用情况，避免因资源耗尽导致服务异常

总结

这套部署方案为Synology DS918+ NAS提供了一个完整、安全的家庭媒体中心解决方案。通过合理的网络规划和服务组织，可以充分发挥NAS设备的性能，同时保证系统的安全性和可维护性。用户可以根据自己的需求灵活调整配置，构建个性化的家庭媒体环境。