vastsa/FileCodeBox

vastsa/FileCodeBox has 8,771 GitHub stars and 1,087 forks. GitHot measured +3 stars in 24 hours. Last checked 2026-11-07 16:53 UTC. Last push 2026-10-27.

How these counts are measured

文件快递柜-匿名口令分享文本，文件，像拿快递一样取文件（FileCodeBox - File Express Cabinet - Anonymous Passcode Sharing Text, Files, Like Taking Express Delivery for Files）

8,771 stars 1,087 forks +3 in 24h

Measured star growth

in 24h: +3
in 7 days: Collecting history
in 15 days: Collecting history
in 1 month: Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

readme_en.md

Original

FileCodeBox

Share files like picking up a package

A lightweight, modern, self-hosted file sharing service. No account required—upload, share the passcode, and retrieve.

Live Demo　·　Documentation　·　简体中文

Start with one command

docker run -d --restart unless-stopped \
  -p 12345:12345 \
  -v ./data:/app/data \
  -e APP_ENV=production \
  -e LOG_LEVEL=warning \
  --log-opt max-size=10m \
  --log-opt max-file=3 \
  --name filecodebox \
  lanol/filecodebox:2.8.5 # x-release-please-version

Open http://localhost:12345 and complete first-run setup. Pin a version in production; latest tracks the newest stable release.

MCP for AI clients

FileCodeBox supports MCP over Streamable HTTP, allowing compatible AI clients to create text and file shares. Use http://<your-server>:12345/mcp (or http://localhost:12345/mcp for a local instance). No token is required by default. The available tools are share_text and share_file. If guest uploads are disabled or MCP token validation is enabled, configure Authorization: Bearer <admin token> in the client.

See the MCP integration guide.

Simple, yet capable

Share instantly
_{Files and text in one flow, with drag, paste, batch, and chunked uploads.}

Expire on your terms
_{Expire by time or retrieval count, keep forever, and clean up automatically.}

Own your data
_{Local, S3, OneDrive, WebDAV, and OpenDAL storage on infrastructure you control.}

From sharing to administration

FastAPI　Vue 3　SQLite　Docker　S3　WebDAV　Dark Mode

Learn more

Getting started · deployment, setup, and upgrades
Storage · local and object storage
Security · rate limits, sessions, and access protection
API reference · upload, retrieval, and administration
Frontend source · the active 2024 theme

Contributing

Issues and pull requests are welcome. FileCodeBox is released under LGPL-3.0.

Disclaimer

Use FileCodeBox only for lawful file and text sharing. Do not upload, store, or distribute illegal, infringing, or unauthorized content. Operators are responsible for deployment security, data compliance, and content moderation.

If FileCodeBox helps you, consider leaving a Star.