一個瀏覽器擴充元件，讓你直接在右鍵選單上傳圖片、影片、音訊到你自己的 Zipline 伺服器，並支援 URL 縮短、自動刪除、觀看次數限制等功能。
1. 為什麼選擇自架 Zipline？
市面上的圖床與檔案分享服務，說關就關、說改規則就改規則。你辛苦上傳的截圖、影片、素材，哪一天平台改變政策或關閉，連結就永久失效。
Zipline1 是完全自架的開源分享伺服器，你的檔案存在你自己的機器上：
- 分享的自由度完全在你手裡：要永久有效、要限時自動銷毀、要設定只能看幾次——全都你說了算，不受任何第三方限制。
- 檔案的持久性由你掌控：伺服器是你的，資料是你的，連結能活多久取決於你的伺服器，不是某個公司的商業決策。
- 隱私有保障：上傳動作只與你自己的伺服器通訊，這個擴充元件不收集任何遙測資料，沒有任何第三方網路請求。
除了跟 vscode、typora 之類的編輯器整合外2，這個擴充元件讓你把 Zipline 的上傳功能直接整合進瀏覽器右鍵選單，省去每次手動開網頁上傳的麻煩。
2. 功能特色
| 功能 | 說明 |
|---|---|
| 右鍵快速上傳 | 對任意圖片、影片、音訊右鍵 → 直接上傳到你的 Zipline |
| 連結縮短 | 對任意連結右鍵 → 用 Zipline 縮短網址（可選） |
| 自動刪除 | 設定上傳後幾小時 / 幾天 / 一年後自動銷毀 |
| 觀看次數上限 | 限制分享連結最多能被開啟幾次後自動失效 |
| 圖片格式轉換 | 上傳前在瀏覽器端將圖片轉為 WebP / AVIF / JPEG / PNG |
| 圖片壓縮 | 伺服器端壓縮，減少儲存空間佔用 |
| 自動複製連結 | 上傳完成後自動將返回的 URL 複製到剪貼簿 |
| 跨瀏覽器 | Chrome 與 Firefox 皆支援，同一份程式碼建置 |
3. 安裝方式
3.1. Firefox（推薦）
直接從 Firefox Add-ons 頁面 安裝，點「加入 Firefox」即可。
3.2. Chrome / Edge（手動載入）
- 前往 Releases 下載最新的
upload-to-zipline-X.Y.Z-chrome.zip。 - 解壓縮後，開啟
chrome://extensions（Edge 則是edge://extensions）。 - 啟用右上角的「開發人員模式」。
- 點「載入未封裝項目」，選擇解壓縮後的資料夾。
4. 設定教學
4.1. 第一步：取得 Zipline 的上傳端點與 Token
- 登入你的 Zipline 管理後台。
- 前往帳號設定，找到「Export to ShareX (.sxcu)」或類似匯出功能。
- 下載或複製其中的：
- Request URL：通常格式為
https://你的網域/api/upload - Authorization Token：你的個人驗證金鑰
- Request URL：通常格式為
如果你的 Zipline 有自訂網域，Request URL 就填你自己的網域，例如
https://i.example.com/api/upload。
4.2. 第二步：在擴充元件填入設定
- 點擊瀏覽器工具列上的擴充元件圖示，開啟設定彈窗。
- 也可以右鍵擴充元件圖示 → 「管理擴充功能」→「選項」開啟完整設定頁。
- 填入 Request URL 與 Authorization Token。
- 依需求開啟以下進階選項：
4.2.1. 自動刪除（Upload Expiry）
開啟後，選擇上傳檔案在多久後自動從伺服器刪除：
| 選項 | 說明 |
|---|---|
| 1 小時 ～ 1 年 | 到期後 Zipline 自動刪除該檔案，分享連結同時失效 |
適合用於：臨時分享截圖、只需要對方看一次的資料。
4.2.2. 觀看次數上限（Max Views）
開啟後，填入數字。該分享連結被開啟達到上限次數後，Zipline 自動使其失效。
適合用於：確保檔案只被特定幾個人看到。
4.2.3. 右鍵縮短連結（URL Shortening）
開啟後，對任何超連結按右鍵會多出「Shorten URL with Zipline」選項，將長網址縮短為你的 Zipline 短連結。
4.2.4. 圖片格式轉換（Image Conversion）
開啟後，上傳圖片前會先在瀏覽器端轉換格式。可選 WebP、AVIF、JPEG、PNG，並調整品質（0～100）。
提示：選擇 WebP 或 AVIF 可大幅縮小檔案大小，節省伺服器空間。
4.2.5. 圖片壓縮（Image Compression）
開啟後，上傳時帶上壓縮指令，讓 Zipline 伺服器在儲存時壓縮圖片。
注意：若同時開啟「圖片格式轉換」，壓縮由瀏覽器端處理，此選項會被略過。
- 點擊「Save Settings」儲存。
4.3. 第三步：開始使用
設定完成後，對任意圖片、影片、音訊按右鍵，選擇「Upload to Zipline」。
上傳完成後，會彈出通知，並自動將返回的分享連結複製到剪貼簿，直接貼上即可分享。
5. 常見問答
Q：上傳失敗怎麼辦？
請確認：
- Request URL 格式正確（結尾通常是
/api/upload）。 - Authorization Token 未過期或未被撤銷。
- 你的 Zipline 伺服器正在運行且可從外部存取。
Q：設定會存在哪裡？
設定存在瀏覽器的 storage.sync，若你的 Firefox 或 Chrome 帳號有啟用同步，設定會自動同步到其他登入相同帳號的裝置。
Q：這個元件會收集我的資料嗎？
不會。所有網路請求只發往你自己設定的 Zipline 伺服器，沒有任何第三方流量。
Q：支援哪些媒體類型？
支援瀏覽器可辨識的圖片（jpg、png、gif、webp 等）、影片（mp4、webm 等）、音訊（mp3、ogg 等）。右鍵選單只在這些媒體元素上顯示。