kilrah/freefilesync-vnc

FreeFileSync VNC Docker镜像文档

镜像概述与主要用途

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

本Docker镜像基于https://github.com/helfrichmichael/prusaslicer-novnc%E6%9E%84%E5%BB%BA%EF%BC%8C%E9%80%9A%E8%BF%87VNC%E5%8D%8F%E8%AE%AE%E6%8F%90%E4%BE%9BFreeFileSync%E5%9B%BE%E5%BD%A2%E7%95%8C%E9%9D%A2%E8%AE%BF%E9%97%AE%E8%83%BD%E5%8A%9B%EF%BC%8C%E4%B8%BB%E8%A6%81%E9%9D%A2%E5%90%91Unraid%E7%B3%BB%E7%BB%9F%E7%94%A8%E6%88%B7%EF%BC%8C%E6%96%B9%E4%BE%BF%E5%9C%A8%E6%9C%8D%E5%8A%A1%E5%99%A8%E7%8E%AF%E5%A2%83%E4%B8%AD%E9%80%9A%E8%BF%87%E5%9B%BE%E5%BD%A2%E7%95%8C%E9%9D%A2%E9%85%8D%E7%BD%AE%E5%92%8C%E7%AE%A1%E7%90%86%E6%96%87%E4%BB%B6%E5%90%8C%E6%AD%A5%E4%BB%BB%E5%8A%A1%E3%80%82

核心功能与特性

• 免费开源同步能力：集成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命令

bash
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配置

yaml
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仓库：https://github.com/kilrah/docker-templates