文件

BridgeFile 文件

設定同使用 BridgeFile 進行安全檔案傳輸所需嘅一切。

文件亦有提供 English

快速開始

等候首個公開版本期間，先了解 BridgeFile 嘅連線同傳輸流程。

SFTP 設定

BridgeFile 支援完整嘅 SFTP 連線,包括密碼同 SSH 金鑰驗證,亦支援有密語保護嘅金鑰。

Host:     myserver.example.com
Port:     22
Username: deploy
Auth:     Password(儲存喺 OS keychain)

Host:       production.example.com
Port:       22
Username:   ubuntu
Auth:       SSH Key
Key File:   ~/.ssh/id_ed25519
Passphrase: (可選,儲存喺 keychain)

FTP / FTPS 設定

BridgeFile 支援純 FTP 同 FTPS(FTP over TLS)嘅隱含同明確模式,底層使用 basic-ftp。

Host:      ftp.example.com
Port:      21        # 990 用於隱含 FTPS
Username:  uploader
Password:  ********
Use FTPS:  Explicit TLS(或 "Implicit" / "None")

S3 設定(單桶模式)

BridgeFile 嘅 S3 單桶模式讓你喺只授權特定儲存桶同前綴嘅 IAM 政策下工作。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "ListOnlyAssignedPrefix",
      "Effect": "Allow",
      "Action": "s3:ListBucket",
      "Resource": "arn:aws:s3:::my-company-assets",
      "Condition": {
        "StringLike": {
          "s3:prefix": [
            "team-a/uploads/*"
          ]
        }
      }
    },
    {
      "Sid": "DenyListingOtherPrefixes",
      "Effect": "Deny",
      "Action": "s3:ListBucket",
      "Resource": "arn:aws:s3:::my-company-assets",
      "Condition": {
        "StringNotLike": {
          "s3:prefix": [
            "team-a/uploads/*"
          ]
        }
      }
    },
    {
      "Sid": "WorkWithAssignedObjects",
      "Effect": "Allow",
      "Action": [
        "s3:GetObject",
        "s3:PutObject",
        "s3:DeleteObject"
      ],
      "Resource": "arn:aws:s3:::my-company-assets/team-a/uploads/*"
    }
  ]
}

Endpoint:  https://<account>.r2.cloudflarestorage.com
Region:    auto
Bucket:    my-r2-bucket
Prefix:    (可選)

傳輸檔案

BridgeFile 提供多種方式喺本機同遠端系統之間搬移檔案,可續傳嘅佇列會追蹤每個傳輸嘅進度。

• —拖放: 喺本機同遠端窗格之間拖放,或從作業系統檔案管理員拖入任一窗格。
• —右鍵選單: 上傳、下載、刪除、重新命名、編輯、權限、比對、校驗碼驗證。
• —鍵盤: Ctrl/Cmd + U 上傳、Ctrl/Cmd + D 下載、Delete 刪除、F2 重新命名。
• —批次選取: Shift + click 範圍選取、Ctrl/Cmd + click 逐個選取。
• —續傳: 中斷嘅 SFTP 同 FTP 傳輸可以從上次停止嘅位置續傳。

多分頁連線

同時喺平行分頁中開啟多個 SFTP、FTP 同 S3 連線。拖曳分頁重新排序。用 Ctrl/Cmd + Tab 切換分頁。Ctrl/Cmd + W 關閉目前分頁。

站點管理員同群組

左側欄嘅站點管理員儲存每個連線 profile。收藏最愛、組織伺服器入可摺疊群組、用書籤儲存常用嘅遠端路徑。

• —收藏: 將最常用嘅伺服器釘喺列表頂部。
• —群組: 將連線嵌入資料夾:staging、production、customer-x 等等。
• —書籤: 儲存 /var/www/app/releases 等遠端路徑,一按即到。

跳板主機 / SSH 代理

對於喺 bastion / 跳板主機後面嘅 SFTP 連線,喺連線設定中啟用 '跳板主機'。BridgeFile 會透明地穿隧 SFTP session 經過跳板主機 — 唔需要手動設定 ProxyCommand。

# 目標伺服器
Host:      db.internal.example.com
Port:      22
Username:  ops

# 跳板主機
Proxy Host:      bastion.example.com
Proxy Port:      22
Proxy Username:  alvin
Proxy Password:  (或 SSH 金鑰)

遠端檔案編輯器

右鍵按遠端文字檔案揀 '編輯',即可喺內建編輯器中開啟。儲存 (Ctrl/Cmd + S) 時 BridgeFile 會原子性地上傳變更返去。最適合快速改 nginx/env 檔案,唔使再用 scp 嚟回。

資料夾比對

右鍵按任何資料夾揀 '比對資料夾'。BridgeFile 會列出本機同遠端之間缺少、較新或不同嘅檔案。一鍵雙向同步。

Glob 搜尋

喺任何窗格按 Ctrl/Cmd + F,用 glob pattern 遞迴搜尋。SFTP、FTP、S3 全部支援。雙擊結果即可跳至位置。

**/*.log
uploads/2026-*/invoice-*.pdf
node_modules/**/.DS_Store

校驗碼驗證

右鍵按檔案揀 '校驗碼驗證',即可計算本機同遠端副本嘅 MD5 或 SHA-256。BridgeFile 比較兩者並顯示 '相符' / '不相符'。大傳輸經過不穩網路後最啱用。

主題同語言

• —主題: Ctrl/Cmd + Shift + T 切換深色同淺色模式;或喺設定中跟隨系統偏好。
• —語言: 英文同繁體中文 (zh-TW)。喺設定中切換 (Ctrl/Cmd + ,)。
• —面板: 拖曳中央分隔線調整窗格大小;摺疊傳輸佇列節省空間。