安裝

前往官網下載，會根據你的作業系統自動選擇對應的版本進行下載。
前往 GitHub 下載，可以自行選擇對應的版本下載。

Windows

Windows 分成兩個版本，一個是安裝包版本還有一個是免安裝版本，大家可以依照自己的喜好進行選擇。

免安裝版本檔案名稱為：Gopeed-v1.x.x-windows-amd64-portable.zip

Macos

Macos 版本提供了.dmg文件，雙擊即可安裝，安裝套件支援intel和apple silicon兩種架構。

附註：macos 版本執行如果提示損壞，請在終端執行 xattr -d com.apple.quarantine /Applications/Gopeed.app 指令

Linux

Flatpak

flatpak install flathub com.gopeed.Gopeed

flatpak install flathub com.gopeed.Gopeed

Snap

sudo snap install gopeed

sudo snap install gopeed

除此之外，還提供了.deb和.AppImage兩種安裝包，可以自行選擇下載安裝。

Android

Android 版本提供了.apk文件，可以直接下載安裝，支援所有的 CPU 架構。

iOS

目前 iOS 平台只提供了.ipa文件，需要自行簽名安裝，建議使用TrollStore(巨魔商店)進行安裝。

為什麼沒有上架到 App Store？
因為蘋果的審核機制，不允許 BitTorrent 協定相關 App 上架。
為什麼沒有上架到 TestFlight？
因為沒錢！專案純為愛發電，如果能得到足夠的贊助，會立刻上架到 TestFlight，所以請多多支持，開源不易，感謝！

Web

如果你需要一個遠端下載服務，那麼可以考慮使用 Web 版本，Gopeed 提供了各個平台的 Web 版本，你可以根據自己的系統和 cpu 架構進行下載。

這裡我以 Windows 平台為例，介紹如何使用 Web 版本，其它平台的使用方式也類似。

下載 Web 版本，解壓縮後會得到一個資料夾，將其放到你想要的位置。

在資料夾根目錄中開啟終端，執行./gopeed.exe，如果執行成功會看到下列輸出：

bash


  _______   ______   .______    _______  _______  _______
/  _____| /  __  \  |   _  \  |   ____||   ____||       \
|  |  __  |  |  |  | |  |_)  | |  |__   |  |__   |  .--.  |
|  | |_ | |  |  |  | |   ___/  |   __|  |   __|  |  |  |  |
|  |__| | |  `--'  | |  |      |  |____ |  |____ |  '--'  |
\______|  \______/  | _|      |_______||_______||_______/

Server start success on http://[::]:9999


  _______   ______   .______    _______  _______  _______
/  _____| /  __  \  |   _  \  |   ____||   ____||       \
|  |  __  |  |  |  | |  |_)  | |  |__   |  |__   |  .--.  |
|  | |_ | |  |  |  | |   ___/  |   __|  |   __|  |  |  |  |
|  |__| | |  `--'  | |  |      |  |____ |  |____ |  '--'  |
\______|  \______/  | _|      |_______||_______||_______/

Server start success on http://[::]:9999

開啟瀏覽器，造訪http://localhost:9999 即可。

Web 配置

Web 版支援命令列參數或設定檔進行配置，命令列參數可以透過./gopeed.exe -h查看：

$ ./gopeed.exe -h
Usage of C:\Users\levi\Downloads\gopeed-web-v1.3.13-windows-amd64\gopeed.exe:
   -A string
         Bind Address (default "0.0.0.0")
   -P int
         Bind Port (default 9999)
   -T string
         API token, that can only be used when basic authentication is enabled.
   -c string
         Config file path (default "./config.json")
   -d string
         Storage directory
   -p string
         HTTP Basic Auth Password
   -u string
         HTTP Basic Auth Username (default "gopeed")

$ ./gopeed.exe -h
Usage of C:\Users\levi\Downloads\gopeed-web-v1.3.13-windows-amd64\gopeed.exe:
   -A string
         Bind Address (default "0.0.0.0")
   -P int
         Bind Port (default 9999)
   -T string
         API token, that can only be used when basic authentication is enabled.
   -c string
         Config file path (default "./config.json")
   -d string
         Storage directory
   -p string
         HTTP Basic Auth Password
   -u string
         HTTP Basic Auth Username (default "gopeed")

同時也支援透過設定檔進行配置，在根目錄下建立config.json文件，內容如下：

json

{
  "address": "", // 綁定的IP位址（預設：0.0.0.0)
  "port": 0, // 綁定的連接埠（預設：9999)
  "username": "", // 服務身分認證使用者名，為空時不啟用身分認證
  "password": "", // 服務認證密碼（預設：gopeed)
  "apiToken": "", // HTTP API 令牌，在啟用身分認證的情況下使用 HTTP API 時，必須設定令牌
  "storageDir": "", // 存储目錄
  "whiteDownloadDirs": ["/root/downloads", "/root/dir/*", "/root/dir?abc"] // 下載目錄白名單，當配置了此選項時，所有下載到非白名單資料夾的任務都會失敗，支援通配符，規則參考 https://pkg.go.dev/path/filepath#Match
}

{
  "address": "", // 綁定的IP位址（預設：0.0.0.0)
  "port": 0, // 綁定的連接埠（預設：9999)
  "username": "", // 服務身分認證使用者名，為空時不啟用身分認證
  "password": "", // 服務認證密碼（預設：gopeed)
  "apiToken": "", // HTTP API 令牌，在啟用身分認證的情況下使用 HTTP API 時，必須設定令牌
  "storageDir": "", // 存储目錄
  "whiteDownloadDirs": ["/root/downloads", "/root/dir/*", "/root/dir?abc"] // 下載目錄白名單，當配置了此選項時，所有下載到非白名單資料夾的任務都會失敗，支援通配符，規則參考 https://pkg.go.dev/path/filepath#Match
}

注意：如果你是在公網 ip 部署，建議啟用身份認證，否則會有安全風險。

預設下載配置

如果需要在伺服器首次啟動的時候設定預設下載配置，可以在config.json中添加downloadConfig欄位，配置詳情參考：DownloaderStoreConfig，示例：

json

{
  "address": "127.0.0.1",
  "port": 9999,
  "downloadConfig": {
    "downloadDir": "d:/test" // 設定預設下載目錄
  }
}

{
  "address": "127.0.0.1",
  "port": 9999,
  "downloadConfig": {
    "downloadDir": "d:/test" // 設定預設下載目錄
  }
}

Docker

直接一行指令即可運行：

docker run --name gopeed -d -p 9999:9999 liwei2633/gopeed

docker run --name gopeed -d -p 9999:9999 liwei2633/gopeed

掛載下載目錄

docker run --name gopeed -d -p 9999:9999 -v /path/to/download:/app/Downloads liwei2633/gopeed

docker run --name gopeed -d -p 9999:9999 -v /path/to/download:/app/Downloads liwei2633/gopeed

掛載資料目錄

docker run --name gopeed -d -p 9999:9999 -v /path/to/download:/app/Downloads -v /path/to/storage:/app/storage liwei2633/gopeed

docker run --name gopeed -d -p 9999:9999 -v /path/to/download:/app/Downloads -v /path/to/storage:/app/storage liwei2633/gopeed

指定容器群組 ID 和使用者 ID

docker run --name gopeed -e PGID=100 -e PUID=1000 liwei2633/gopeed

docker run --name gopeed -e PGID=100 -e PUID=1000 liwei2633/gopeed

如果需要啟用身份認證，可以傳遞命令列參數(參考上一節Web 設定)：

docker run --name gopeed -d -p 9999:9999 -v /path/to/download:/app/Downloads -v /path/to/storage:/app/storage liwei2633/gopeed -u admin -p 123456

docker run --name gopeed -d -p 9999:9999 -v /path/to/download:/app/Downloads -v /path/to/storage:/app/storage liwei2633/gopeed -u admin -p 123456

命令列

命令列版本需要依賴Golang環境，如果你沒有安裝Golang環境，可以參考這裡進行安裝。

安裝命令：

go install github.com/GopeedLab/gopeed/cmd/gopeed@latest

go install github.com/GopeedLab/gopeed/cmd/gopeed@latest

安裝完成就可以使用gopeed指令進行下載了，具體使用方法可以透過gopeed -h查看：

$ gopeed -h
Usage of gopeed:
   -C int
         Concurrent connections. (default 16)
   -D string
         Store directory. (default "C:\\Users\\levi")

$ gopeed -h
Usage of gopeed:
   -C int
         Concurrent connections. (default 16)
   -D string
         Store directory. (default "C:\\Users\\levi")

命令列使用範例

下載一個 HTTP 資源：

gopeed https://example.com/file.zip

gopeed https://example.com/file.zip

下載一個種子檔：

gopeed D:/Downloads/file.torrent

gopeed D:/Downloads/file.torrent

下載一個磁力連結：

gopeed magnet:?xt=urn:btih:xxxx

gopeed magnet:?xt=urn:btih:xxxx

安裝 ​

Windows ​

Macos ​

Linux ​

Android ​

iOS ​

Web ​

Web 配置 ​

預設下載配置 ​

Docker ​

命令列 ​

命令列使用範例 ​

安裝