Gopeed 文件

正體中文

English
简体中文

正體中文

English
简体中文

Appearance

安裝 ​

  1. 前往 官網 下載，會根據你的作業系統自動選擇對應的版本進行下載。
  2. 前往 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

    sh
    flatpak install flathub com.gopeed.Gopeed
    flatpak install flathub com.gopeed.Gopeed

  • Snap

    sh
    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 版本，其它平台的使用方式也類似。

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

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

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

Server start success on http://[::]:9999
    
  _______   ______   .______    _______  _______  _______
/  _____| /  __  \  |   _  \  |   ____||   ____||       \
|  |  __  |  |  |  | |  |_)  | |  |__   |  |__   |  .--.  |
|  | |_ | |  |  |  | |   ___/  |   __|  |   __|  |  |  |  |
|  |__| | |  `--'  | |  |      |  |____ |  |____ |  '--'  |
\______|  \______/  | _|      |_______||_______||_______/

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

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

Web 配置 ​

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

sh
$ ./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 ​

直接一行指令即可運行：

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

掛載下載目錄

sh
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

掛載資料目錄

sh
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

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

sh
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環境，可以參考這裡進行安裝。

安裝命令：

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

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

sh
$ 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 資源：

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

下載一個種子檔：

sh
gopeed D:/Downloads/file.torrent
gopeed D:/Downloads/file.torrent

下載一個磁力連結：

sh
gopeed magnet:?xt=urn:btih:xxxx
gopeed magnet:?xt=urn:btih:xxxx