{"id":46,"date":"2025-08-17T11:17:56","date_gmt":"2025-08-17T03:17:56","guid":{"rendered":"https:\/\/www.eastsun.top\/?p=46"},"modified":"2025-08-17T11:17:56","modified_gmt":"2025-08-17T03:17:56","slug":"%e2%91%a3-syncthing-%e4%b8%aa%e4%ba%ba%e7%bd%91%e7%9b%98%ef%bc%9a%e4%bb%8e-docker-%e9%83%a8%e7%bd%b2%e5%88%b0%e7%9b%b4%e8%bf%9e-quic%e3%80%81%e5%8f%8d%e4%bb%a3%e4%b8%8e%e6%8e%92%e9%9a%9c%e5%85%a8","status":"publish","type":"post","link":"https:\/\/www.eastsun.top\/?p=46","title":{"rendered":"\u2463 Syncthing \u4e2a\u4eba\u7f51\u76d8\uff1a\u4ece Docker \u90e8\u7f72\u5230\u76f4\u8fde\/QUIC\u3001\u53cd\u4ee3\u4e0e\u6392\u969c\u5168\u8bb0\u5f55"},"content":{"rendered":"

\u76ee\u6807\uff1a\u7528 <\/span>Docker Compose<\/b> \u5728\u670d\u52a1\u5668\u4e0a\u90e8\u7f72 <\/span>Syncthing<\/b>\uff0c\u901a\u8fc7 <\/span>Nginx \u53cd\u5411\u4ee3\u7406 + HTTPS<\/b> \u66b4\u9732\u7ba1\u7406\u754c\u9762\uff0c\u6570\u636e\u901a\u9053\u8d70 <\/span>\u76f4\u8fde TCP\/UDP\/QUIC<\/b>\uff1b\u540c\u65f6\u6c89\u6dc0\u8e29\u5751\u548c\u89e3\u51b3\u65b9\u6848\u3002<\/span><\/p><\/blockquote>\n

\u8bf4\u660e\uff1a\u6587\u4e2d\u5df2\u8131\u654f<\/b><\/span>\uff0c\u793a\u4f8b\u57df\u540d\u4ee5 sync.example.com<\/span> \u8868\u793a\uff0c\u516c\u7f51\u5730\u5740\u4ee5 SERVER_IP<\/span> \u8868\u793a\u3002\u9ed8\u8ba4\u4ee5 admin<\/b><\/span> \u8d26\u53f7\u3001\u5bb6\u76ee\u5f55 \/home\/admin<\/span> \u64cd\u4f5c\uff08\u975e \/root<\/span>\uff09\u3002<\/p><\/blockquote>\n

\n

\u3010\u5b9e\u64cd\u6559\u5b66\u3011<\/b><\/h1>\n

\u4e00\u3001\u76ee\u6807\u4e0e\u8bbe\u8ba1<\/b><\/h2>\n
    \n
  • \n

    \u7ba1\u7406\u754c\u9762\uff08Web GUI\uff09\u53ea\u5728\u672c\u673a\u56de\u73af<\/b><\/span>\u76d1\u542c \u2192 \u901a\u8fc7 Nginx\/443<\/b><\/span> \u5bf9\u5916\u63d0\u4f9b\uff1ahttps:\/\/sync.example.com<\/span><\/p>\n<\/li>\n

  • \n

    \u6570\u636e\u540c\u6b65\u901a\u9053\u8d70 <\/span>22000\/TCP + 22000\/UDP(QUIC)<\/b>\uff0c\u5b9e\u73b0<\/span>\u76f4\u8fde<\/b>\uff08\u53ef\u7ed5\u8fc7\u4e2d\u7ee7\uff0c\u52a0\u901f\uff09\u3002<\/span><\/p>\n<\/li>\n

  • \n

    \u6587\u4ef6\u4e0e\u914d\u7f6e\u5168\u90e8\u6301\u4e45\u5316\u5230 admin \u5bb6\u76ee\u5f55<\/b><\/span>\uff0c\u5347\u7ea7\/\u91cd\u5efa\u5bb9\u5668\u4e0d\u4e22\u6570\u636e\u3002<\/p>\n<\/li>\n<\/ul>\n

    \n

    \u4e8c\u3001\u521b\u5efa\u76ee\u5f55\u4e0e\u83b7\u53d6 UID\/GID\uff08\u5199 compose \u524d\u5148\u62ff\u5230\u503c\uff09<\/b><\/h2>\n
    mkdir -p \/home\/admin\/syncthing\/{config,data}        # mkdir\uff1a\u521b\u5efa\u76ee\u5f55\uff1b-p\uff1a\u7236\u76ee\u5f55\u4e0d\u5b58\u5728\u65f6\u4e00\u5e76\u521b\u5efa\r\n# config\uff1a\u653e Syncthing \u914d\u7f6e\r\n# data\uff1a\u793a\u4f8b\u8d44\u6599\u5e93\uff08\u4f60\u4e5f\u53ef\u6362\u6210\u5176\u4ed6\u8def\u5f84\uff09\r\n\r\nid -u admin                                          # id -u\uff1a\u67e5\u770b\u7528\u6237 UID\uff08User ID\uff09\r\nid -g admin                                          # id -g\uff1a\u67e5\u770b\u7528\u6237 GID\uff08Group ID\uff09\r\n# \u8bb0\u4e0b\u8fd9\u4e24\u4e2a\u6570\u5b57\uff0c\u4e0b\u9762 PUID\/PGID \u8981\u7528\u5230<\/code><\/pre>\n
    \u672f\u8bed<\/p><\/blockquote>\n
      \n
    • \n
      UID\/GID<\/b><\/span>\uff1a\u8fd0\u884c\u5bb9\u5668\u65f6\u201c\u4ee5\u54ea\u4e2a\u7cfb\u7edf\u7528\u6237\u8eab\u4efd\u8bfb\u5199\u6587\u4ef6\u201d\u3002\u7528 admin \u7684 UID\/GID\uff0c\u907f\u514d\u751f\u6210 root \u5c5e\u4e3b\u6587\u4ef6\u5bfc\u81f4\u6743\u9650\u95ee\u9898\u3002<\/p><\/blockquote>\n<\/li>\n<\/ul>\n
      \n
      \u4e09\u3001\u7f16\u5199 <\/b><\/h2>\n
      docker-compose.yml<\/b><\/h2>\n
      cd \/home\/admin\/syncthing                              # cd\uff1a\u5207\u6362\u76ee\u5f55\uff08change directory\uff09\r\nnano docker-compose.yml                               # nano\uff1a\u6253\u5f00\u7f16\u8f91\u5668<\/code><\/pre>\n
      \u7c98\u8d34\u4ee5\u4e0b\uff08<\/span>V2 \u5199\u6cd5\uff0c\u65e0 version: \u9876\u7ea7\u5b57\u6bb5<\/b>\uff09\uff1a<\/span><\/p>\n
      services:\r\n  syncthing:\r\n    image: syncthing\/syncthing:latest                 # \u5b98\u65b9\u955c\u50cf\r\n    container_name: syncthing\r\n    restart: unless-stopped                           # \u5f02\u5e38\u9000\u51fa\u81ea\u52a8\u91cd\u542f\r\n    environment:\r\n      - PUID=YOUR_UID                                 # \u7528\u4e0a\u4e00\u6b65\u7684 UID\uff0c\u4f8b\u5982 1003\r\n      - PGID=YOUR_GID                                 # \u7528\u4e0a\u4e00\u6b65\u7684 GID\uff0c\u4f8b\u5982 1003\r\n      - TZ=Asia\/Shanghai                              # \u65f6\u533a\r\n    volumes:\r\n      - \/home\/admin\/syncthing\/config:\/var\/syncthing   # \u914d\u7f6e\u6301\u4e45\u5316\r\n      - \/home\/admin\/syncthing\/data:\/data              # \u793a\u4f8b\u8d44\u6599\u5e93\uff08\u5bb9\u5668\u5185\u8def\u5f84 \/data\uff09\r\n    # \u7ba1\u7406\u53e3\u4ec5\u56de\u73af\u8bbf\u95ee \u2192 \u901a\u8fc7 Nginx \u53cd\u4ee3\r\n    ports:\r\n      - \"127.0.0.1:8384:8384\"                         # Web GUI\uff08\u56de\u73af\uff0c\u4e0d\u5bf9\u516c\u7f51\uff09\r\n    # \u6570\u636e\u901a\u9053\uff1a\u76f4\u8fde\u6240\u9700\uff08\u5982\u53ea\u8d70\u4e2d\u7ee7\uff0c\u53ef\u5148\u6ce8\u91ca\uff0c\u540e\u7eed\u518d\u542f\uff09\r\n    # \u82e5\u8981\u76f4\u8fde\/QUIC\uff0c\u8bf7\u53d6\u6d88\u6ce8\u91ca\u8fd9\u4e24\u884c\uff0c\u5e76\u5728\u4e91\u9632\u706b\u5899\u653e\u884c 22000\/TCP+UDP\r\n      - \"0.0.0.0:22000:22000\/tcp\"                     # \u6570\u636e\u901a\u9053 TCP\uff08\u516c\u7f51\u53ef\u8fbe\uff09\r\n      - \"0.0.0.0:22000:22000\/udp\"                     # \u6570\u636e\u901a\u9053 UDP\uff08QUIC\uff09<\/code><\/pre>\n
      \u4fdd\u5b58\uff08Ctrl+O<\/span> \u56de\u8f66\uff09\u2192 \u9000\u51fa\uff08Ctrl+X<\/span>\uff09\u3002<\/p>\n
      \u8bf4\u660e<\/p><\/blockquote>\n
        \n
      • \n
        \u7ba1\u7406\u754c\u9762\u53ea\u5728 127.0.0.1:8384<\/span> \u76d1\u542c\uff0c\u4e0d\u4f1a\u5916\u9732<\/b><\/span>\uff1b\u901a\u8fc7 Nginx \u7684 443 \u8bbf\u95ee\u3002<\/p><\/blockquote>\n<\/li>\n
      • \n
        \u6570\u636e\u901a\u9053\u7528 0.0.0.0<\/span> \u6620\u5c04 22000\uff08TCP\/UDP\uff09\uff0c\u7528\u4e8e\u8de8\u8bbe\u5907\u76f4\u8fde<\/b><\/span>\u3002<\/p><\/blockquote>\n<\/li>\n
      • \n
        \u521d\u671f\u53ea\u60f3\u201c\u80fd\u7528\u201d\uff0c\u53ef\u4ee5\u5148\u6ce8\u91ca<\/b><\/span> 22000 \u4e24\u884c\uff0c\u5b8c\u6210\u53cd\u4ee3\u4e0e\u57fa\u7840\u540c\u6b65\u540e\u518d\u653e\u5f00\u76f4\u8fde\u3002<\/p><\/blockquote>\n<\/li>\n<\/ul>\n
        \n
        \u56db\u3001\u542f\u52a8\u4e0e\u57fa\u672c\u81ea\u68c0<\/b><\/h2>\n
        docker compose up -d                                   # up -d\uff1a\u6309\u7f16\u6392\u542f\u52a8\u5e76\u540e\u53f0\u8fd0\u884c\r\ndocker compose ps                                      # ps\uff1a\u67e5\u770b\u72b6\u6001\u4e0e\u7aef\u53e3\u6620\u5c04\r\ncurl -I http:\/\/127.0.0.1:8384                         # -I\uff1a\u53ea\u770b\u54cd\u5e94\u5934\uff1b200\/302 \u8868\u793a GUI \u540e\u7aef\u5de5\u4f5c\u6b63\u5e38<\/code><\/pre>\n
        \n
        \u4e94\u3001\u914d\u7f6e Nginx \u53cd\u5411\u4ee3\u7406\uff08\u5b9d\u5854\u9762\u677f\uff09<\/b><\/h2>\n
        1\uff09\u5728\u9762\u677f<\/span>\u6dfb\u52a0\u7ad9\u70b9<\/b><\/span>\uff1a<\/span>sync.example.com\uff0c\u7c7b\u578b\u9009<\/span>\u9759\u6001<\/b><\/span>\u3002<\/span><\/p>\n
        2\uff09\u7ad9\u70b9 \u2192 \u53cd\u5411\u4ee3\u7406<\/b><\/span>\uff1a\u76ee\u6807 URL \u586b http:\/\/127.0.0.1:8384\/<\/span> \u2192 \u542f\u7528\u3002<\/p>\n
        3\uff09\u7ad9\u70b9 \u2192 SSL<\/b><\/span>\uff1a\u7533\u8bf7 Let\u2019s Encrypt \u2192 \u5f3a\u5236 HTTPS<\/b><\/span>\u3002<\/p>\n
        4\uff09\u786e\u4fdd\u53cd\u4ee3\u6bb5\u5305\u542b\u8fd9 6 \u884c\u201c\u9ec4\u91d1\u8bf7\u6c42\u5934\u201d\uff08\u907f\u514d\u6837\u5f0f\/JS\/URL\u95ee\u9898\uff09\uff1a<\/p>\n
        proxy_set_header Host              $host;          # \u4f20\u9012\u539f\u59cb\u57df\u540d\r\nproxy_set_header X-Real-IP         $remote_addr;   # \u4f20\u9012\u5ba2\u6237\u7aef IP\r\nproxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;\r\nproxy_set_header X-Forwarded-Proto $scheme;        # \u4f20\u9012 https\/http \u534f\u8bae\r\nproxy_set_header X-Forwarded-Host  $host;\r\nproxy_set_header X-Forwarded-Port  $server_port;<\/code><\/pre>\n
        \u73b0\u5728\u8bbf\u95ee https:\/\/sync.example.com<\/b><\/span>\uff0c\u5e94\u80fd\u770b\u5230 Syncthing \u7684 Web \u754c\u9762\u3002<\/p>\n
        \n
        \u516d\u3001\u9996\u767b\u4e0e\u8d44\u6599\u5e93\uff08Folder\uff09\u521b\u5efa<\/b><\/h2>\n
        1\uff09\u9996\u6b21\u8bbf\u95ee\u4f1a\u5f15\u5bfc\u8bbe\u7f6e GUI \u7528\u6237\/\u5bc6\u7801\uff08\u8bf7\u4f7f\u7528\u5f3a\u5bc6\u7801<\/b><\/span>\uff09\u3002<\/p>\n
        2\uff09\u70b9\u51fb <\/span>Add Folder\uff08\u65b0\u589e\u8d44\u6599\u5e93\uff09<\/b>\uff1a<\/span><\/p>\n
          \n
        • \n
          Folder Label\uff1aNotes<\/span>\uff08\u4e3e\u4f8b\uff09<\/p>\n<\/li>\n
        • \n
          Folder Path\uff1a<\/span>\/data\/Notes\uff08\u5bb9\u5668\u5185\u8def\u5f84\uff1b\u6211\u4eec\u6620\u5c04\u5230\u4e86\u5bbf\u4e3b\u673a <\/span>\/home\/admin\/syncthing\/data\/Notes\uff09<\/span><\/p>\n<\/li>\n
        • \n
          Advanced \u2192 File Versioning\uff1a\u53ef\u5148\u5173\u95ed\uff08\u540e\u671f\u518d\u5f00\uff09<\/p>\n<\/li>\n
        • \n
          \u4fdd\u5b58\u540e Syncthing \u4f1a\u5728\u5bbf\u4e3b\u673a\u5bf9\u5e94\u4f4d\u7f6e\u521b\u5efa\u6587\u4ef6\u5939\u3002<\/p>\n<\/li>\n<\/ul>\n
          \u5982\u679c\u4f60\u5728 Mac\/PC \u5ba2\u6237\u7aef\u4e5f\u52a0\u4e86 Notes<\/span> \u5e76\u5171\u4eab\u7ed9\u670d\u52a1\u5668\uff0c\u5f88\u5feb\u4f1a\u5f00\u59cb\u540c\u6b65\u3002<\/p><\/blockquote>\n
          \n
          \u4e03\u3001\u76f4\u8fde\/QUIC \u52a0\u901f\uff08\u53ef\u9009\u4f46\u63a8\u8350\uff09<\/b><\/h2>\n
          1\uff09\u5f00\u542f\u7aef\u53e3\u6620\u5c04\uff08\u4f60\u5728 compose \u91cc\u5df2\u5199\uff09<\/b><\/h3>\n
            \n
          • \n
            \u53d6\u6d88\u6ce8\u91ca\uff08\u6216\u4fdd\u7559\uff09\u4ee5\u4e0b\u4e24\u884c\uff1a<\/p>\n<\/li>\n<\/ul>\n
            - \"0.0.0.0:22000:22000\/tcp\"\r\n- \"0.0.0.0:22000:22000\/udp\"<\/code><\/pre>\n
              \n
            • <\/li>\n
            • \n
              \u5e94\u7528\u53d8\u66f4\uff1a<\/p>\n<\/li>\n<\/ul>\n
              cd \/home\/admin\/syncthing                      # \u786e\u4fdd\u5728\u9879\u76ee\u76ee\u5f55\r\ndocker compose up -d                          # \u8ba9\u7f16\u6392\u6309\u65b0\u914d\u7f6e\u91cd\u5efa\r\ndocker compose restart syncthing              # \u5efa\u8bae\u91cd\u542f\u5bb9\u5668\u4e00\u6b21\uff08\u5b9e\u8df5\u8868\u660e\u66f4\u5e72\u51c0\uff09<\/code><\/pre>\n
              2\uff09\u4e91\u9632\u706b\u5899\u653e\u884c<\/b><\/h3>\n
                \n
              • \n
                \u5141\u8bb8 22000\/TCP<\/b><\/span> \u4e0e 22000\/UDP<\/b><\/span>\uff08\u4ec5\u5b9e\u4f8b\u5165\u7ad9\uff09\u300280\/443\/22 \u4fdd\u6301\u539f\u72b6\u3002<\/p>\n<\/li>\n<\/ul>\n
                3\uff09\u5ba2\u6237\u7aef\u4fa7\u68c0\u67e5\uff08\u4ee5 Mac \u5ba2\u6237\u7aef\u4e3a\u4f8b\uff09<\/b><\/h3>\n
                  \n
                • \n
                  \u6253\u5f00 Syncthing \u2192 <\/span>Actions \u2192 Settings \u2192 Connections<\/b>\uff1a<\/span><\/p>\n
                    \n
                  • \n
                    \u52fe\u9009 TCP<\/b><\/span> \u4e0e QUIC<\/b><\/span>\uff08\u9ed8\u8ba4\u90fd\u662f\u5f00\u7684\uff09\uff1b<\/p>\n<\/li>\n
                  • \n
                    \u4fdd\u6301 NAT traversal<\/b><\/span>\uff08NAT \u7a7f\u900f\uff09\u5f00\u542f\uff1b<\/p>\n<\/li>\n
                  • \n
                    \u82e5\u4f60\u6709\u516c\u7f51\u53d7\u9650\uff0c\u53ef\u5728 Global Discovery<\/b><\/span> \u4fdd\u6301\u5f00\u542f\uff08\u53d1\u73b0\u670d\u52a1\uff09\u3002<\/p>\n<\/li>\n<\/ul>\n<\/li>\n
                  • \n
                    \u5728 <\/span>Devices \u2192 \u670d\u52a1\u5668\u8bbe\u5907 \u2192 Edit<\/b>\uff1a<\/span><\/p>\n
                      \n
                    • \n
                      \u53ef\u5728 <\/span>Addresses<\/b><\/span> \u589e\u52a0 <\/span>tcp:\/\/SERVER_IP:22000, quic:\/\/SERVER_IP:22000 \u5f3a\u5316\u76f4\u8fbe\uff08\u9009\u586b\uff09\u3002<\/span><\/p>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n
                      4\uff09\u9a8c\u8bc1\u8fde\u63a5\u7c7b\u578b<\/b><\/h3>\n
                        \n
                      • \n
                        \u8bbe\u5907\u89c6\u56fe\u91cc\uff0cAddress\/Type<\/b><\/span> \u663e\u793a QUIC<\/span> \u6216 TCP (WAN)<\/span> \u5373\u8868\u793a\u5e7f\u57df\u7f51\u76f4\u8fde\uff1b<\/p>\n<\/li>\n
                      • \n
                        \u5982\u679c\u603b\u662f\u8d70 Relay\uff08\u4e2d\u7ee7\uff09<\/b><\/span>\uff0c\u591a\u534a\u662f\u7aef\u53e3\u672a\u901a\u6216\u6709\u4e2d\u95f4\u8bbe\u5907\u5c4f\u853d\u4e86 UDP\u3002<\/p>\n<\/li>\n<\/ul>\n
                        \u5b9e\u6218\u7ecf\u9a8c\uff1a<\/span>\u6539\u5b8c\u7aef\u53e3\u4e0e\u89c4\u5219\u540e\uff0c\u91cd\u542f\u5bb9\u5668<\/b><\/span>\uff08<\/span>docker compose restart syncthing\uff09\u5f80\u5f80\u6709\u52a9\u4e8e\u5c3d\u5feb\u5207\u5230 QUIC\u3002<\/span><\/p><\/blockquote>\n
                        \n
                        \u516b\u3001\u5e38\u7528\u8fd0\u7ef4<\/b><\/h2>\n
                        cd \/home\/admin\/syncthing                         # \u5207\u5230\u9879\u76ee\u76ee\u5f55\r\ndocker compose ps                                # \u67e5\u770b\u72b6\u6001\/\u7aef\u53e3\u6620\u5c04\r\ndocker compose logs -f syncthing                 # \u5b9e\u65f6\u65e5\u5fd7\uff08Ctrl+C \u9000\u51fa\uff09\r\ndocker compose restart syncthing                 # \u91cd\u542f\u5bb9\u5668\uff08\u914d\u7f6e\/\u7aef\u53e3\u53d8\u66f4\u540e\u5efa\u8bae\uff09\r\ndocker compose down                              # \u505c\u6b62\u5e76\u79fb\u9664\u5bb9\u5668\uff08\u6570\u636e\u4ecd\u4fdd\u7559\u5728 \/home\/admin\/syncthing\uff09<\/code><\/pre>\n
                        \u6682\u505c\u540c\u6b65<\/b><\/span>\uff08\u4e34\u65f6\uff09\uff1a<\/p>\n
                          \n
                        • \n
                          Web GUI \u67d0\u8d44\u6599\u5e93\u53f3\u4e0a\u89d2 \u2192 Pause<\/b><\/span>\uff1b<\/p>\n<\/li>\n
                        • \n
                          \u6216\u6682\u505c\u67d0\u8bbe\u5907\u8fde\u63a5\u3002<\/p>\n<\/li>\n<\/ul>\n
                          \u5220\u9664\u670d\u52a1\u5668\u7aef\u67d0\u8d44\u6599\u5e93\u7684\u6587\u4ef6<\/b>\uff08\u8c28\u614e\uff09\uff1a<\/span><\/p>\n
                          rm -rf \/home\/admin\/syncthing\/data\/Notes\/*        # rm -rf\uff1a\u9012\u5f52\u5f3a\u5236\u5220\u9664\uff1b*\uff1a\u5220\u9664 Notes \u4e0b\u6240\u6709\u5185\u5bb9\r\n# \u5efa\u8bae\u5148\u5728 GUI \u91cc\u6682\u505c\u8be5\u8d44\u6599\u5e93\u7684\u540c\u6b65\uff0c\u518d\u505a\u5220\u9664\uff0c\u907f\u514d\u4e00\u8fb9\u5220\u4e00\u8fb9\u53c8\u88ab\u5bf9\u7aef\u540c\u6b65\u56de\u6765<\/code><\/pre>\n
                          \u5ffd\u7565\u6587\u4ef6\u89c4\u5219 .stignore<\/b>\uff08\u653e\u5728\u8d44\u6599\u5e93\u6839\u76ee\u5f55\uff09\uff1a<\/span><\/p>\n
                          nano \/home\/admin\/syncthing\/data\/Notes\/.stignore  # \u65b0\u5efa\u6216\u7f16\u8f91\u5ffd\u7565\u89c4\u5219\r\n# \u4f8b\u5982\uff1a\r\n# *.tmp\r\n# node_modules\/\r\n# .DS_Store<\/code><\/pre>\n
                          \n
                          \u8e29\u5751\u4e0e\u89e3\u51b3\u65b9\u6848<\/b><\/h1>\n
                            \n
                          1. \n
                            \u6539\u4e86\u914d\u7f6e\u4ecd\u65e7 TCP\uff0c\u4e0d\u8d70 QUIC<\/b><\/b><\/p>\n