File Share - 區域網路檔案分享服務

區域網路內的串流檔案上下傳服務。A 上傳檔案，B 即可下載。

快速啟動（Docker Hub，無需 Clone）

docker run -d -p 80:80 --name file-share screenleon/file-share

瀏覽器開啟 http://<你的IP> 即可使用。

停止時會自動清理所有上傳的檔案：

docker stop file-share && docker rm file-share

若需要永久保留上傳檔案，掛載 volume：

docker run -d -p 80:80 -v fileshare_data:/app/uploads --name file-share screenleon/file-share

從原始碼啟動（Docker Compose）

啟動

docker compose up -d --build

瀏覽器開啟 http://<你的IP> 即可使用。

停止（自動清理所有上傳檔案）

docker compose down -v

-v 會刪除 uploads volume，清除所有上傳的檔案。

若只想停止服務但保留檔案：

docker compose down

架構

Browser ──▶ Nginx (:80) ──▶ Go Backend (:8080) ──▶ Disk
               │
               └── 靜態前端 (HTML/CSS/JS)

• 後端: Go — 串流 I/O，1GB+ 檔案記憶體消耗極低
• 前端: 靜態 HTML + 拖曳上傳 + 進度條
• 反向代理: Nginx — 無上傳大小限制、關閉 buffering

API

Method	Path	說明
POST	/api/upload	上傳檔案（multipart/form-data, field: files）
GET	/api/files	列出所有檔案
GET	/api/download/{filename}	下載檔案
DELETE	/api/files/{filename}	刪除檔案

查看區域網路 IP

# Linux
hostname -I

# macOS
ifconfig | grep "inet " | grep -v 127.0.0.1

# Windows
ipconfig

將 IP 分享給同網路的人即可存取。