FreeFileSync VNC Docker镜像文档

镜像概述与主要用途

FreeFileSync是一款免费开源的文件同步工具，支持Windows、Linux及macOS系统，提供文件/文件夹的双向同步、镜像同步等功能，项目通过用户***维持开发。

本Docker镜像基于helfrichmichael/prusaslicer-novnc构建，通过VNC协议提供FreeFileSync图形界面访问能力，主要面向Unraid系统用户，方便在服务器环境中通过图形界面配置和管理文件同步任务。

核心功能与特性

• 免费开源同步能力：集成FreeFileSync核心功能，支持双向同步、镜像同步、更新同步等多种模式，完全免费且开源。
• VNC图形界面：通过VNC协议提供远程图形化操作界面，无需本地安装客户端即可配置同步任务。
• 路径隔离机制：支持映射两个专用路径（/home/freefilesync/path1和/home/freefilesync/path2），用于访问待同步文件/文件夹，避免直接操作容器文件系统导致存储空间快速占用。
• 数据持久化：/home/freefilesync/appdata目录可映射至宿主机，持久化存储日志、应用配置及同步配置文件（profiles）。
• Unraid权限适配：默认采用Unraid系统用户/组权限配置，兼容Unraid环境的文件访问控制模型。

使用场景与适用范围

• Unraid服务器文件同步：适用于Unraid用户在服务器内执行跨磁盘、跨共享文件夹的文件同步任务。
• 图形化同步规则配置：需要可视化设置同步过滤条件、定时任务、冲突解决策略等高级选项的场景。
• 轻量级远程管理：通过VNC客户端远程访问容器，无需本地安装FreeFileSync即可完成同步任务的创建与维护。

使用方法与配置说明

前置要求

• Docker环境（推荐Unraid系统，镜像针对其权限模型优化）。
• VNC客户端（如RealVNC、TightVNC等）用于连接容器界面。

路径映射说明

注意：仅通过上述路径访问文件，直接操作容器其他目录会导致镜像存储空间快速填满。

Docker部署示例

Docker Run命令

docker run -d \
  --name freefilesync-vnc \
  -p 5900:5900 \  # VNC默认端口，可修改宿主机端口（如5901:5900）
  -v /mnt/user/share1:/home/freefilesync/path1 \  # 映射宿主机同步路径1
  -v /mnt/user/share2:/home/freefilesync/path2 \  # 映射宿主机同步路径2
  -v /mnt/user/appdata/freefilesync:/home/freefilesync/appdata \  # 持久化配置目录
  kilrah/freefilesync-vnc

Docker Compose配置

version: '3'
services:
  freefilesync-vnc:
    image: kilrah/freefilesync-vnc
    container_name: freefilesync-vnc
    ports:
      - "5900:5900"  # VNC端口映射
    volumes:
      - /mnt/user/share1:/home/freefilesync/path1  # 同步路径1
      - /mnt/user/share2:/home/freefilesync/path2  # 同步路径2
      - /mnt/user/appdata/freefilesync:/home/freefilesync/appdata  # 配置持久化
    restart: unless-stopped  # 容器退出时自动重启

访问与操作说明

1. 连接VNC界面：使用VNC客户端连接宿主机IP:端口（如192.168.1.100:5900），默认无需密码（具体依VNC服务配置）。
2. 界面操作注意事项：
   • 若窗口无响应：可能是FreeFileSync***提示弹窗被主窗口遮挡，拖动主窗口即可显示弹窗并关闭。
   • 最小化窗口恢复：中键点击桌面调出窗口切换器，选择FreeFileSync窗口。
   • 多实例管理：右键桌面空白处可打开新的FreeFileSync实例。

相关资源

• Unraid支持线程：Unraid forums
• GitHub仓库：kilrah/docker-templates