如何搭建閱後即焚文件快遞櫃（FileCodeBox ）

FileCodeBox 是一款基於FastAPI + Vue3 開發的輕量級文件分享系統。它模仿取快遞的模式，當用戶上傳文件後會生成一個「取件碼」，接收者只需要只需輸入該碼即可提取文件。

這次教程的項目搭建在搬瓦工E-Commerce SLA 系列 VPS上。E-Commerce SLA 系列99.99% 的SLA保障和頂級中國優化線路，可以完美解決我們在傳輸和分享文件時遇到的痛點：

防泄露與省流量： 支持「閱後即焚」及下載次數限制，有效防止鏈接被二次傳播導致數據泄露，並節省服務器流量。
規避平台審查： 解決微信、QQ 等社交軟件自動修改文件格式或直接屏蔽文件的問題，確保任何文件都能成功發送。
極速免登錄： 徹底擺脫網盤限速和「強制登錄才能下載」的煩人限制，配合搬瓦工中國優化線路實現滿速提取。

需要準備的事項：

1.擁有一台搬瓦工的服務器（參考教程）；

2.服務器在運行，且安裝了debian12系統（參考教程）；

3.擁有一個域名（反向代理需要）；

4. SSH 連接工具已準備就緒（例如 Xshell）。

一、連接服務器並安裝 FileCodeBox

FileCodeBox 需要用到Docker，本部分將一併完成 Docker 環境的安裝。

1.SSH 連接與基礎工具安裝

使用 SSH 工具連接到您的搬瓦工服務器（推薦使用 Xshell 等工具，如果你是個人或家庭使用，可以下載 Xshell：下載鏈接），

然後執行下方命令安裝必要的工具。

apt-get install wget curl vim sudo unzip -y

為了優化編輯體驗，執行以下命令，防止後期使用 vi 編輯時出現剪貼板或格式報錯：

echo set clipboard=unnamed >> ~/.vimrc

2.安裝並啟動 Docker

執行下方命令安裝 Docker，安裝過程預計耗時數十秒。

wget -qO- get.docker.com | bash

Docker 安裝完成後，執行以下命令啟動 Docker 服務並設置開機自啟：

systemctl start docker
systemctl enable docker

3.創建 FileCodeBox 目錄

創建一個目錄用於存放 Docker 配置文件和相關數據，並進入該目錄：

mkdir FileCodeBox && cd FileCodeBox

4.創建 Docker Compose 文件

在 FileCodeBox 目錄下，執行下方命令，創建一個 docker-compose.yml 文件：

vi docker-compose.yml

進入 vi 編輯頁面後，按下鍵盤 i 鍵進入編輯模式，將以下配置複製進去，按下鍵盤 ESC 鍵退出編輯模式，然後輸入 :wq，然後按下Enter鍵保存。

version: "3"
services:
  file-code-box:
    image: lanol/filecodebox:latest
    volumes:
      - fcb-data:/app/data:rw
    restart: unless-stopped
    ports:
      - "12345:12345"
volumes:
  fcb-data:
    external: false

5.啟動 FileCodeBox

在 FileCodeBox 目錄下，執行以下命令啟動服務：

docker compose up -d

顯示如下信息，則說明啟動成功。

二、FileCodeBox 的初始配置

安裝完成後，我們需要進入後台進行安全設置。

後台地址： http://你的服务器IP:12345/#/admin
默認管理員密碼： FileCodeBox2023

1. 修改默認密碼

登錄後，請第一時間在後台修改管理員默認密碼，避免被盜用。

2. 上傳參數配置

在系統設置中，根據服務器的實際配置，設置最大上傳文件大小、存儲時長、文件過期策略等參數。

三、如何使用FileCodeBox

FileCodeBox 的默認訪問地址為：http://你的IP:12345

1.發送文件

1.1 FileCodeBox默認界面是取件頁面，點擊要發送件，到發送文件頁面

1.2 設置文件的過期時間或下載次數（如：下載 1 次後銷毀）。

1.3 文件上傳成功後，系統會生成取件碼、分享鏈接及二維碼等。

2.取文件

2.1 取件碼取文件：直接訪問默認地址你的IP:12345，然後輸入取件碼

以下是取件頁面。

2.2 二維碼取文件：手機掃描二維碼，直達文件下載頁面。

2.3 鏈接提取：接收者直接訪問分享鏈接即可進入提取頁面。

四、進階優化：配置反向代理

為了方便記憶訪問地址並啟用 HTTPS （提高安全性），建議配合安裝 Nginx Proxy Manager (NPM) 進行反向代理。

如何搭建Nginx Proxy Manager並使用反向代理和遠程桌面加速

默認情況下，FileCodeBox參數如下。

location / {
    proxy_set_header X-Real-IP $remote_addr;      # 设置真实客户端IP
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_pass http://localhost:12345; 
}