Marrrrrrrrry d701c6e00e chore: engineering hardening - test tooling, lint, security fix, and cleanup
- add pyproject.toml with pytest config and dev dependency group (PEP 735)
- add ruff (core correctness rules) + pre-commit hook
- fix stored XSS: html.escape site config before index template injection,
  with regression tests
- log previously swallowed cleanup exceptions in upload rollback paths
- consolidate three duplicate path generators into build_file_path
  (also aligns chunk/presign date dirs to get_now() instead of local time)
- drop redundant ip_limit sync in load_config (refresh_settings covers all limiters)
- remove dead code (calculate_file_hash, commented-out block), two orphan
  guide docs, and stale .gitignore entries
- add dependabot for pip, docker, and github-actions
- bump starlette 1.3.1 -> 1.6.0 (no breaking API changes; verified with the
  full test suite plus an ASGI smoke test incl. Range downloads)
- skip theme asset tests when themes/ is not built locally
2026-09-07 23:43:50 +08:00
2022-12-11 11:07:38 +08:00
2026-09-01 16:08:44 +00:00
2023-11-15 23:23:53 +08:00
2026-09-01 16:08:44 +00:00

FileCodeBox

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 · 简体中文

Release Docker Pulls Stars License


FileCodeBox

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.5.6 # x-release-please-version

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

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

File sharing screen Admin dashboard
Admin login File management System settings

FastAPI Vue 3 SQLite Docker S3 WebDAV Dark Mode

Learn more

If you enjoy self-hosted “box” tools, also check out this project from the same author:

BokeBox · Private AI Podcast Box

Drop in videos, links, or drafts, and get listen-worthy personal podcasts with custom host persona and voice.

BokeBox banner

BokeBox home

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.

S
Description
文件快递柜-匿名口令分享文本,文件,像拿快递一样取文件(FileCodeBox - File Express Cabinet - Anonymous Passcode Sharing Text, Files, Like Taking Express Delivery for Files)
Readme
34 MiB
0 Stars 1 Watchers 0 Forks
Languages
Python 99.4%
Dockerfile 0.6%