Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
00f1f1d8da | ||
|
|
5a7195c5c7 | ||
|
|
da1dd06655 | ||
|
|
d510aa7f57 | ||
|
|
cebac32145 | ||
|
|
f76d1e9841 | ||
|
|
287b647da1 | ||
|
|
fbcd4a5b2b | ||
|
|
fc0cbeb4f0 |
No files matched your search
|
Before Width: | Height: | Size: 571 KiB |
|
Before Width: | Height: | Size: 557 KiB |
|
Before Width: | Height: | Size: 205 KiB |
|
Before Width: | Height: | Size: 679 KiB |
|
Before Width: | Height: | Size: 684 KiB |
|
Before Width: | Height: | Size: 411 KiB |
|
Before Width: | Height: | Size: 431 KiB |
|
Before Width: | Height: | Size: 579 KiB |
|
Before Width: | Height: | Size: 201 KiB |
|
Before Width: | Height: | Size: 254 KiB |
|
Before Width: | Height: | Size: 200 KiB |
|
Before Width: | Height: | Size: 514 KiB |
|
Before Width: | Height: | Size: 674 KiB |
|
Before Width: | Height: | Size: 678 KiB |
|
Before Width: | Height: | Size: 219 KiB |
|
After Width: | Height: | Size: 69 KiB |
|
After Width: | Height: | Size: 55 KiB |
|
Before Width: | Height: | Size: 240 KiB |
|
After Width: | Height: | Size: 92 KiB |
|
Before Width: | Height: | Size: 192 KiB |
|
After Width: | Height: | Size: 94 KiB |
|
Before Width: | Height: | Size: 233 KiB |
|
After Width: | Height: | Size: 29 KiB |
|
Before Width: | Height: | Size: 78 KiB |
|
Before Width: | Height: | Size: 54 KiB |
|
Before Width: | Height: | Size: 94 KiB |
|
Before Width: | Height: | Size: 78 KiB |
|
After Width: | Height: | Size: 27 KiB |
|
Before Width: | Height: | Size: 138 KiB |
|
After Width: | Height: | Size: 38 KiB |
|
Before Width: | Height: | Size: 171 KiB |
|
After Width: | Height: | Size: 68 KiB |
@@ -1,3 +1,3 @@
|
||||
{
|
||||
".": "2.5.3"
|
||||
".": "2.5.5"
|
||||
}
|
||||
@@ -63,14 +63,7 @@ RUN apt-get update \
|
||||
&& apt-get upgrade -y --no-install-recommends \
|
||||
&& rm -rf /var/lib/apt/lists/* \
|
||||
&& pip install --no-cache-dir -r requirements.txt \
|
||||
&& pip cache purge || true \
|
||||
&& groupadd --system --gid 1000 appuser \
|
||||
&& useradd --system --uid 1000 --gid appuser --create-home --home-dir /home/appuser --shell /usr/sbin/nologin appuser \
|
||||
&& mkdir -p /app/data \
|
||||
&& chown -R appuser:appuser /app
|
||||
|
||||
# 非 root 运行,降低容器逃逸后的主机影响面
|
||||
USER appuser
|
||||
&& pip cache purge || true
|
||||
|
||||
# 环境变量配置
|
||||
ENV HOST="0.0.0.0" \
|
||||
|
||||
@@ -43,6 +43,7 @@ async def get_chunk_file_path_name(
|
||||
) -> Tuple[str, str, str, str, str]:
|
||||
today = await get_now()
|
||||
storage_path = settings.storage_path.strip("/")
|
||||
file_name = await sanitize_filename(unquote(file_name or ""))
|
||||
base_path = f"share/data/{today.strftime('%Y/%m/%d')}/{upload_id}"
|
||||
path = f"{storage_path}/{base_path}" if storage_path else base_path
|
||||
prefix, suffix = os.path.splitext(file_name)
|
||||
|
||||
@@ -393,7 +393,8 @@ async def parse_complete_upload(request: Request) -> CompleteUploadModel:
|
||||
|
||||
@chunk_api.post("/upload/init/", dependencies=[Depends(share_required_login)])
|
||||
async def init_chunk_upload(data: InitChunkUploadModel = Depends(parse_init_chunk_upload)):
|
||||
validate_file_type(data.file_name)
|
||||
safe_file_name = await sanitize_filename(unquote(data.file_name or ""))
|
||||
validate_file_type(safe_file_name)
|
||||
# 服务端校验:根据 total_chunks * chunk_size 计算理论最大上传量
|
||||
total_chunks = (data.file_size + data.chunk_size - 1) // data.chunk_size
|
||||
max_possible_size = total_chunks * data.chunk_size
|
||||
@@ -423,7 +424,7 @@ async def init_chunk_upload(data: InitChunkUploadModel = Depends(parse_init_chun
|
||||
chunk_hash=data.file_hash,
|
||||
chunk_index=-1,
|
||||
file_size=data.file_size,
|
||||
file_name=data.file_name,
|
||||
file_name=safe_file_name,
|
||||
).first()
|
||||
|
||||
if existing_session:
|
||||
@@ -459,7 +460,9 @@ async def init_chunk_upload(data: InitChunkUploadModel = Depends(parse_init_chun
|
||||
await reserve_storage(
|
||||
reservation_token, data.file_size, ttl_seconds=chunk_expire_seconds
|
||||
)
|
||||
_, _, _, _, save_path = await get_chunk_file_path_name(data.file_name, upload_id)
|
||||
_, _, _, safe_file_name, save_path = await get_chunk_file_path_name(
|
||||
data.file_name, upload_id
|
||||
)
|
||||
try:
|
||||
await UploadChunk.create(
|
||||
upload_id=upload_id,
|
||||
@@ -468,7 +471,7 @@ async def init_chunk_upload(data: InitChunkUploadModel = Depends(parse_init_chun
|
||||
file_size=data.file_size,
|
||||
chunk_size=data.chunk_size,
|
||||
chunk_hash=data.file_hash,
|
||||
file_name=data.file_name,
|
||||
file_name=safe_file_name,
|
||||
save_path=save_path,
|
||||
)
|
||||
except Exception:
|
||||
@@ -670,7 +673,8 @@ async def complete_upload(
|
||||
|
||||
save_path = chunk_info.save_path
|
||||
path = os.path.dirname(save_path) if save_path else ""
|
||||
prefix, suffix = os.path.splitext(chunk_info.file_name)
|
||||
safe_file_name = os.path.basename(save_path) if save_path else ""
|
||||
prefix, suffix = os.path.splitext(safe_file_name)
|
||||
|
||||
try:
|
||||
# 合并文件并计算哈希
|
||||
@@ -689,7 +693,7 @@ async def complete_upload(
|
||||
expired_count=expired_count,
|
||||
used_count=used_count,
|
||||
file_path=path,
|
||||
uuid_file_name=f"{prefix}{suffix}",
|
||||
uuid_file_name=safe_file_name,
|
||||
prefix=prefix,
|
||||
suffix=suffix,
|
||||
)
|
||||
@@ -699,7 +703,7 @@ async def complete_upload(
|
||||
await UploadChunk.filter(upload_id=upload_id).delete()
|
||||
await release_storage(f"chunk:{upload_id}")
|
||||
ip_limit["upload"].add_ip(ip)
|
||||
return APIResponse(detail={"code": code, "name": chunk_info.file_name})
|
||||
return APIResponse(detail={"code": code, "name": safe_file_name})
|
||||
except ValueError as e:
|
||||
raise HTTPException(status.HTTP_400_BAD_REQUEST, detail=str(e))
|
||||
except Exception as e:
|
||||
|
||||
@@ -116,6 +116,8 @@ class SystemFileStorage(FileStorageInterface):
|
||||
"""将相对路径解析到数据根目录内,阻止路径穿越。"""
|
||||
root = self.root_path.resolve()
|
||||
raw = str(relative_path or "").replace("\\", "/").lstrip("/")
|
||||
if any(part == ".." for part in raw.split("/")):
|
||||
raise ValueError("非法文件路径")
|
||||
candidate = (root / raw).resolve()
|
||||
try:
|
||||
candidate.relative_to(root)
|
||||
|
||||
@@ -1,8 +1,7 @@
|
||||
version: "3"
|
||||
services:
|
||||
file-code-box:
|
||||
image: lanol/filecodebox:2.5.3 # x-release-please-version
|
||||
user: "1000:1000"
|
||||
image: lanol/filecodebox:2.5.5 # x-release-please-version
|
||||
volumes:
|
||||
- fcb-data:/app/data:rw
|
||||
restart: unless-stopped
|
||||
|
||||
@@ -1,5 +1,22 @@
|
||||
# Changelog
|
||||
|
||||
## [2.5.5](https://github.com/vastsa/FileCodeBox/compare/v2.5.4...v2.5.5) (2026-08-29)
|
||||
|
||||
|
||||
### Bug Fixes
|
||||
|
||||
* **chunk-upload:** persist sanitized filenames ([da1dd06](https://github.com/vastsa/FileCodeBox/commit/da1dd066551cc7cc9a631a0c982b5675bd4b1967))
|
||||
* harden chunk upload filename metadata ([5a7195c](https://github.com/vastsa/FileCodeBox/commit/5a7195c5c7d1028500b0e363c6b47130d260e11c))
|
||||
* sanitize chunk upload file_name to prevent path traversal ([cebac32](https://github.com/vastsa/FileCodeBox/commit/cebac32145f948bfca7c44c663a0bcdcd9c56830))
|
||||
|
||||
## [2.5.4](https://github.com/vastsa/FileCodeBox/compare/v2.5.3...v2.5.4) (2026-07-23)
|
||||
|
||||
|
||||
### Bug Fixes
|
||||
|
||||
* run Docker as root for volume compatibility ([fbcd4a5](https://github.com/vastsa/FileCodeBox/commit/fbcd4a5b2b788cdfc8e86d920f9c5a7299dc839a))
|
||||
* run Docker image as root for data volume compatibility ([fc0cbeb](https://github.com/vastsa/FileCodeBox/commit/fc0cbeb4f0c7485d2e7abc0501a5fd9b1456cc22))
|
||||
|
||||
## [2.5.3](https://github.com/vastsa/FileCodeBox/compare/v2.5.2...v2.5.3) (2026-07-23)
|
||||
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
## [Unreleased]
|
||||
|
||||
<!-- Current release: 2.5.3 x-release-please-version -->
|
||||
<!-- Current release: 2.5.5 x-release-please-version -->
|
||||
|
||||
### Added
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
<div align="center">
|
||||
|
||||
<img src="https://fastly.jsdelivr.net/gh/vastsa/FileCodeBox@V1.6/static/banners/img_1.png" alt="FileCodeBox Logo">
|
||||
<img src="/screenshots/retrieve.webp" alt="FileCodeBox" width="860" />
|
||||
|
||||
<p><em>Share text and files anonymously with a passcode, like picking up a package</em></p>
|
||||
|
||||
|
||||
@@ -4,6 +4,10 @@ FileCodeBox provides a fully-featured admin panel that allows administrators to
|
||||
|
||||
## Accessing the Admin Panel
|
||||
|
||||
<p align="center">
|
||||
<img src="/screenshots/login.webp" alt="Admin login" width="640" />
|
||||
</p>
|
||||
|
||||
### Login Method
|
||||
|
||||
The admin panel is located at the `/admin` path. Access method:
|
||||
@@ -39,6 +43,10 @@ The admin panel uses JWT (JSON Web Token) for authentication:
|
||||
|
||||
## Dashboard
|
||||
|
||||
<p align="center">
|
||||
<img src="/screenshots/dashboard.webp" alt="Dashboard" width="860" />
|
||||
</p>
|
||||
|
||||
After logging in, you first see the dashboard page, which displays the overall system status.
|
||||
|
||||
### Statistics
|
||||
@@ -67,6 +75,10 @@ Storage usage is displayed in bytes. For example, `10485760` represents approxim
|
||||
|
||||
## File Management
|
||||
|
||||
<p align="center">
|
||||
<img src="/screenshots/files.webp" alt="File management" width="860" />
|
||||
</p>
|
||||
|
||||
### File List
|
||||
|
||||
The file management page displays all shared files in the system, supporting pagination and search.
|
||||
@@ -200,6 +212,10 @@ Local file management is useful for:
|
||||
|
||||
## System Settings
|
||||
|
||||
<p align="center">
|
||||
<img src="/screenshots/settings.webp" alt="System settings" width="860" />
|
||||
</p>
|
||||
|
||||
### View Configuration
|
||||
|
||||
On the system settings page, you can view the current values of all configuration items. Configuration items are grouped by category:
|
||||
|
||||
@@ -4,6 +4,10 @@ FileCodeBox provides simple and easy-to-use file and text sharing functionality.
|
||||
|
||||
## Sharing Methods
|
||||
|
||||
<p align="center">
|
||||
<img src="/screenshots/send.webp" alt="Send page" width="720" />
|
||||
</p>
|
||||
|
||||
FileCodeBox supports two sharing methods:
|
||||
|
||||
1. **Text Sharing** - Share text content directly, suitable for code snippets, configuration files, etc.
|
||||
@@ -137,6 +141,10 @@ expire_value=5, expire_style=count
|
||||
|
||||
## Retrieving Files
|
||||
|
||||
<p align="center">
|
||||
<img src="/screenshots/retrieve.webp" alt="Retrieve page" width="720" />
|
||||
</p>
|
||||
|
||||
### How to Use
|
||||
|
||||
1. Enter the extraction code in the "Retrieve File" area on the homepage
|
||||
|
||||
@@ -4,6 +4,10 @@ FileCodeBox provides multiple flexible file upload methods, supporting both regu
|
||||
|
||||
## Upload Methods
|
||||
|
||||
<p align="center">
|
||||
<img src="/screenshots/send.webp" alt="Upload and send page" width="720" />
|
||||
</p>
|
||||
|
||||
FileCodeBox supports the following upload methods:
|
||||
|
||||
### Drag and Drop Upload
|
||||
|
||||
@@ -38,7 +38,7 @@ docker run -d --restart unless-stopped \
|
||||
-p 12345:12345 \
|
||||
-v ./data:/app/data \
|
||||
--name filecodebox \
|
||||
lanol/filecodebox:2.5.3 # x-release-please-version
|
||||
lanol/filecodebox:2.5.5 # x-release-please-version
|
||||
```
|
||||
|
||||
Open `http://localhost:12345` and complete the first-run setup.
|
||||
@@ -61,6 +61,26 @@ Open `http://localhost:12345` and complete the first-run setup.
|
||||
</a>
|
||||
</div>
|
||||
|
||||
## Interface preview
|
||||
|
||||
<p align="center">
|
||||
<img src="/screenshots/retrieve.webp" alt="Retrieve files" width="860" />
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
<img src="/screenshots/send.webp" alt="Send files" width="48%" />
|
||||
|
||||
<img src="/screenshots/dashboard.webp" alt="Admin dashboard" width="48%" />
|
||||
</p>
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="33%"><img src="/screenshots/login.webp" alt="Admin login" /></td>
|
||||
<td width="33%"><img src="/screenshots/files.webp" alt="File management" /></td>
|
||||
<td width="33%"><img src="/screenshots/settings.webp" alt="System settings" /></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
::: warning Responsible use
|
||||
Use FileCodeBox only for lawful file and text sharing. Operators are responsible for deployment security, data compliance, and content moderation.
|
||||
:::
|
||||
@@ -1,6 +1,6 @@
|
||||
<div align="center">
|
||||
|
||||
<img src="https://fastly.jsdelivr.net/gh/vastsa/FileCodeBox@V1.6/static/banners/img_1.png" alt="FileCodeBox Logo">
|
||||
<img src="/screenshots/retrieve.webp" alt="FileCodeBox" width="860" />
|
||||
|
||||
<p><em>匿名口令分享文本和文件,像拿快递一样取文件</em></p>
|
||||
|
||||
@@ -15,6 +15,28 @@
|
||||
</div>
|
||||
|
||||
|
||||
## 🖼️ 界面预览
|
||||
|
||||
<p align="center">
|
||||
<img src="/screenshots/retrieve.webp" alt="提取文件" width="860" />
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
<img src="/screenshots/send.webp" alt="文件发送" width="48%" />
|
||||
|
||||
<img src="/screenshots/dashboard.webp" alt="管理仪表盘" width="48%" />
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
<img src="/screenshots/files.webp" alt="文件管理" width="48%" />
|
||||
|
||||
<img src="/screenshots/settings.webp" alt="系统设置" width="48%" />
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
<img src="/screenshots/login.webp" alt="管理登录" width="60%" />
|
||||
</p>
|
||||
|
||||
## 🚀 更新计划
|
||||
- [ ] 切片上传,同文件秒传,断点续传
|
||||
- [ ] 用户登录重构
|
||||
|
||||
@@ -4,6 +4,10 @@ FileCodeBox 提供了功能完善的管理面板,让管理员可以方便地
|
||||
|
||||
## 访问管理面板
|
||||
|
||||
<p align="center">
|
||||
<img src="/screenshots/login.webp" alt="管理登录" width="640" />
|
||||
</p>
|
||||
|
||||
### 登录方式
|
||||
|
||||
管理面板位于 `/admin` 路径。访问方式:
|
||||
@@ -39,6 +43,10 @@ FileCodeBox 提供了功能完善的管理面板,让管理员可以方便地
|
||||
|
||||
## 仪表盘
|
||||
|
||||
<p align="center">
|
||||
<img src="/screenshots/dashboard.webp" alt="管理仪表盘" width="860" />
|
||||
</p>
|
||||
|
||||
登录后首先看到的是仪表盘页面,展示系统的整体运行状态。
|
||||
|
||||
### 统计指标
|
||||
@@ -67,6 +75,10 @@ FileCodeBox 提供了功能完善的管理面板,让管理员可以方便地
|
||||
|
||||
## 文件管理
|
||||
|
||||
<p align="center">
|
||||
<img src="/screenshots/files.webp" alt="文件管理" width="860" />
|
||||
</p>
|
||||
|
||||
### 文件列表
|
||||
|
||||
文件管理页面展示系统中所有已分享的文件,支持分页浏览和搜索。
|
||||
@@ -199,6 +211,10 @@ FileCodeBox 提供了功能完善的管理面板,让管理员可以方便地
|
||||
|
||||
## 系统设置
|
||||
|
||||
<p align="center">
|
||||
<img src="/screenshots/settings.webp" alt="系统设置" width="860" />
|
||||
</p>
|
||||
|
||||
### 查看配置
|
||||
|
||||
在系统设置页面可以查看当前所有配置项的值。配置项按类别分组显示:
|
||||
|
||||
@@ -4,6 +4,10 @@ FileCodeBox 提供了简单易用的文件和文本分享功能。用户可以
|
||||
|
||||
## 分享方式
|
||||
|
||||
<p align="center">
|
||||
<img src="/screenshots/send.webp" alt="文件发送页面" width="720" />
|
||||
</p>
|
||||
|
||||
FileCodeBox 支持两种分享方式:
|
||||
|
||||
1. **文本分享** - 直接分享文本内容,适合代码片段、配置文件等
|
||||
@@ -136,6 +140,10 @@ expire_value=5, expire_style=count
|
||||
|
||||
## 提取文件
|
||||
|
||||
<p align="center">
|
||||
<img src="/screenshots/retrieve.webp" alt="提取文件页面" width="720" />
|
||||
</p>
|
||||
|
||||
### 使用方法
|
||||
|
||||
1. 在首页的「提取文件」区域输入提取码
|
||||
|
||||
@@ -4,6 +4,10 @@ FileCodeBox 提供了多种灵活的文件上传方式,支持普通上传和
|
||||
|
||||
## 上传方式
|
||||
|
||||
<p align="center">
|
||||
<img src="/screenshots/send.webp" alt="上传与发送页面" width="720" />
|
||||
</p>
|
||||
|
||||
FileCodeBox 支持以下几种上传方式:
|
||||
|
||||
### 拖拽上传
|
||||
|
||||
@@ -38,7 +38,7 @@ docker run -d --restart unless-stopped \
|
||||
-p 12345:12345 \
|
||||
-v ./data:/app/data \
|
||||
--name filecodebox \
|
||||
lanol/filecodebox:2.5.3 # x-release-please-version
|
||||
lanol/filecodebox:2.5.5 # x-release-please-version
|
||||
```
|
||||
|
||||
打开 `http://localhost:12345`,按引导完成首次初始化。
|
||||
@@ -61,6 +61,26 @@ docker run -d --restart unless-stopped \
|
||||
</a>
|
||||
</div>
|
||||
|
||||
## 界面预览
|
||||
|
||||
<p align="center">
|
||||
<img src="/screenshots/retrieve.webp" alt="提取文件" width="860" />
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
<img src="/screenshots/send.webp" alt="文件发送" width="48%" />
|
||||
|
||||
<img src="/screenshots/dashboard.webp" alt="管理仪表盘" width="48%" />
|
||||
</p>
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="33%"><img src="/screenshots/login.webp" alt="管理登录" /></td>
|
||||
<td width="33%"><img src="/screenshots/files.webp" alt="文件管理" /></td>
|
||||
<td width="33%"><img src="/screenshots/settings.webp" alt="系统设置" /></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
::: warning 使用须知
|
||||
请仅将 FileCodeBox 用于合法的文件与文本分享。服务运营者应自行负责部署安全、数据合规和内容管理。
|
||||
:::
|
||||
|
After Width: | Height: | Size: 92 KiB |
|
After Width: | Height: | Size: 94 KiB |
|
After Width: | Height: | Size: 29 KiB |
|
After Width: | Height: | Size: 27 KiB |
|
After Width: | Height: | Size: 38 KiB |
|
After Width: | Height: | Size: 68 KiB |
@@ -17,14 +17,14 @@
|
||||
|
||||
<br />
|
||||
|
||||
<img src="./.github/images/readme/retrieve-dark.png" alt="FileCodeBox 取件页面" width="860" />
|
||||
<img src="./.github/images/readme/banner_zh.webp" alt="FileCodeBox" width="100%" />
|
||||
|
||||
</div>
|
||||
|
||||
## 一条命令开始
|
||||
|
||||
```bash
|
||||
docker run -d --restart unless-stopped -p 12345:12345 -v ./data:/app/data --name filecodebox lanol/filecodebox:2.5.3 # x-release-please-version
|
||||
docker run -d --restart unless-stopped -p 12345:12345 -v ./data:/app/data --name filecodebox lanol/filecodebox:2.5.5 # x-release-please-version
|
||||
```
|
||||
|
||||
访问 `http://localhost:12345`,完成首次初始化。生产环境建议固定版本号;`latest` 指向最新正式版。
|
||||
@@ -43,18 +43,18 @@ docker run -d --restart unless-stopped -p 12345:12345 -v ./data:/app/data --name
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%"><img src="./.github/images/readme/send.png" alt="文件发送页面" /></td>
|
||||
<td width="50%"><img src="./.github/images/readme/dashboard.png" alt="管理仪表盘" /></td>
|
||||
<td width="50%"><img src="./.github/images/readme/send.webp" alt="文件发送页面" /></td>
|
||||
<td width="50%"><img src="./.github/images/readme/dashboard.webp" alt="管理仪表盘" /></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<p align="center">
|
||||
<img src="./.github/images/readme/mobile-retrieve.png" alt="移动端取件" width="29%" />
|
||||
|
||||
<img src="./.github/images/readme/mobile-send.png" alt="移动端发送" width="29%" />
|
||||
|
||||
<img src="./.github/images/readme/mobile-files.png" alt="移动端管理" width="29%" />
|
||||
</p>
|
||||
<table>
|
||||
<tr>
|
||||
<td width="33%"><img src="./.github/images/readme/login.webp" alt="管理登录" /></td>
|
||||
<td width="33%"><img src="./.github/images/readme/files.webp" alt="文件管理" /></td>
|
||||
<td width="33%"><img src="./.github/images/readme/settings.webp" alt="系统设置" /></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<div align="center">
|
||||
|
||||
|
||||
@@ -17,14 +17,14 @@ A lightweight, modern, self-hosted file sharing service. No account required—u
|
||||
|
||||
<br />
|
||||
|
||||
<img src="./.github/images/readme/retrieve-dark.png" alt="FileCodeBox retrieval screen" width="860" />
|
||||
<img src="./.github/images/readme/banner_en.webp" alt="FileCodeBox" width="100%" />
|
||||
|
||||
</div>
|
||||
|
||||
## Start with one command
|
||||
|
||||
```bash
|
||||
docker run -d --restart unless-stopped -p 12345:12345 -v ./data:/app/data --name filecodebox lanol/filecodebox:2.5.3 # x-release-please-version
|
||||
docker run -d --restart unless-stopped -p 12345:12345 -v ./data:/app/data --name filecodebox lanol/filecodebox:2.5.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.
|
||||
@@ -43,18 +43,18 @@ Open `http://localhost:12345` and complete first-run setup. Pin a version in pro
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%"><img src="./.github/images/readme/send.png" alt="File sharing screen" /></td>
|
||||
<td width="50%"><img src="./.github/images/readme/dashboard.png" alt="Admin dashboard" /></td>
|
||||
<td width="50%"><img src="./.github/images/readme/send.webp" alt="File sharing screen" /></td>
|
||||
<td width="50%"><img src="./.github/images/readme/dashboard.webp" alt="Admin dashboard" /></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<p align="center">
|
||||
<img src="./.github/images/readme/mobile-retrieve.png" alt="Mobile retrieval" width="29%" />
|
||||
|
||||
<img src="./.github/images/readme/mobile-send.png" alt="Mobile sharing" width="29%" />
|
||||
|
||||
<img src="./.github/images/readme/mobile-files.png" alt="Mobile administration" width="29%" />
|
||||
</p>
|
||||
<table>
|
||||
<tr>
|
||||
<td width="33%"><img src="./.github/images/readme/login.webp" alt="Admin login" /></td>
|
||||
<td width="33%"><img src="./.github/images/readme/files.webp" alt="File management" /></td>
|
||||
<td width="33%"><img src="./.github/images/readme/settings.webp" alt="System settings" /></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<div align="center">
|
||||
|
||||
|
||||
@@ -90,13 +90,13 @@ class LoginRateLimitTests(SettingsOverrideMixin, unittest.TestCase):
|
||||
self.assertTrue(ip_limit["login"].check_ip("198.51.100.8"))
|
||||
|
||||
|
||||
class DockerNonRootTests(unittest.TestCase):
|
||||
def test_dockerfile_runs_as_non_root_user(self):
|
||||
class DockerRuntimeUserTests(unittest.TestCase):
|
||||
def test_dockerfile_defaults_to_root_for_volume_compatibility(self):
|
||||
# 默认 root:兼容已有 data 卷权限;如需非 root 可由编排层自行指定 user
|
||||
text = Path("Dockerfile").read_text()
|
||||
self.assertIn("USER appuser", text)
|
||||
self.assertIn("--uid 1000", text)
|
||||
self.assertNotIn("USER appuser", text)
|
||||
compose = Path("docker-compose.yml").read_text()
|
||||
self.assertIn('user: "1000:1000"', compose)
|
||||
self.assertNotIn('user: "1000:1000"', compose)
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
|
||||
@@ -1,4 +1,5 @@
|
||||
import asyncio
|
||||
from io import BytesIO
|
||||
import os
|
||||
import tempfile
|
||||
import unittest
|
||||
@@ -6,10 +7,16 @@ from pathlib import Path
|
||||
from unittest.mock import patch
|
||||
|
||||
from fastapi import HTTPException
|
||||
from starlette.datastructures import UploadFile
|
||||
from tortoise import Tortoise
|
||||
|
||||
from apps.base import views
|
||||
from apps.admin import dependencies as admin_dependencies
|
||||
from apps.admin.dependencies import create_token, verify_token
|
||||
from apps.admin.services import LocalFileClass
|
||||
from apps.base.models import FileCodes, UploadChunk
|
||||
from apps.base.schemas import CompleteUploadModel, InitChunkUploadModel
|
||||
from apps.base.utils import get_chunk_file_path_name
|
||||
from core.settings import data_root, settings
|
||||
from core.storage import SystemFileStorage
|
||||
from core.utils import hash_password, verify_password
|
||||
@@ -71,11 +78,133 @@ class SystemStoragePathTests(unittest.TestCase):
|
||||
with self.assertRaises(ValueError):
|
||||
self.storage._resolve_safe_path("../etc/passwd")
|
||||
|
||||
def test_resolve_safe_path_blocks_internal_dotdot(self):
|
||||
with self.assertRaises(ValueError):
|
||||
self.storage._resolve_safe_path("share/data/2026/08/29/x/../../../../../../filecodebox.db")
|
||||
|
||||
def test_resolve_safe_path_blocks_windows_dotdot(self):
|
||||
with self.assertRaises(ValueError):
|
||||
self.storage._resolve_safe_path("share\\data\\..\\..\\filecodebox.db")
|
||||
|
||||
def test_resolve_safe_path_allows_nested(self):
|
||||
target = self.storage._resolve_safe_path("share/data/a/b.txt")
|
||||
self.assertTrue(str(target).startswith(str(Path(self._tmpdir.name).resolve())))
|
||||
|
||||
|
||||
class ChunkFileNameSanitizeTests(unittest.TestCase):
|
||||
def test_chunk_file_path_name_strips_traversal(self):
|
||||
path, _, _, filename, save_path = asyncio.run(
|
||||
get_chunk_file_path_name("../../../../../../filecodebox.db", "a" * 32)
|
||||
)
|
||||
self.assertNotIn("..", save_path)
|
||||
self.assertEqual(filename, "filecodebox.db")
|
||||
self.assertEqual(save_path, f"{path}/filecodebox.db")
|
||||
self.assertIn("a" * 32, path)
|
||||
|
||||
def test_chunk_file_path_name_strips_windows_traversal(self):
|
||||
_, _, _, filename, save_path = asyncio.run(
|
||||
get_chunk_file_path_name("..\\..\\..\\..\\..\\..\\evil.bin", "b" * 32)
|
||||
)
|
||||
self.assertNotIn("..", save_path)
|
||||
self.assertEqual(filename, "evil.bin")
|
||||
|
||||
def test_chunk_file_path_name_keeps_normal_name(self):
|
||||
_, _, _, filename, save_path = asyncio.run(
|
||||
get_chunk_file_path_name("safe.txt", "c" * 32)
|
||||
)
|
||||
self.assertEqual(filename, "safe.txt")
|
||||
self.assertTrue(save_path.endswith("/safe.txt"))
|
||||
|
||||
|
||||
class ChunkUploadMetadataTests(unittest.TestCase):
|
||||
def test_traversal_filename_remains_downloadable_after_completion(self):
|
||||
asyncio.run(self._run_traversal_upload())
|
||||
|
||||
async def _run_traversal_upload(self):
|
||||
original_config = dict(settings.user_config)
|
||||
tmpdir = tempfile.TemporaryDirectory()
|
||||
try:
|
||||
settings.file_storage = "local"
|
||||
settings.allowed_file_types = ["*"]
|
||||
with patch("core.storage.data_root", Path(tmpdir.name)):
|
||||
await Tortoise.init(
|
||||
config={
|
||||
"connections": {
|
||||
"default": {
|
||||
"engine": "tortoise.backends.sqlite",
|
||||
"credentials": {"file_path": ":memory:"},
|
||||
}
|
||||
},
|
||||
"apps": {
|
||||
"models": {
|
||||
"models": ["apps.base.models"],
|
||||
"default_connection": "default",
|
||||
}
|
||||
},
|
||||
"use_tz": False,
|
||||
"timezone": "Asia/Shanghai",
|
||||
}
|
||||
)
|
||||
await Tortoise.generate_schemas()
|
||||
try:
|
||||
raw_name = "../../../../../../filecodebox.db"
|
||||
payload = b"chunk payload"
|
||||
init_result = await views.init_chunk_upload(
|
||||
InitChunkUploadModel(
|
||||
file_name=raw_name,
|
||||
file_size=len(payload),
|
||||
chunk_size=1024,
|
||||
file_hash="f" * 64,
|
||||
)
|
||||
)
|
||||
upload_id = init_result.detail["upload_id"]
|
||||
session = await UploadChunk.get(
|
||||
upload_id=upload_id, chunk_index=-1
|
||||
)
|
||||
self.assertEqual(session.file_name, "filecodebox.db")
|
||||
self.assertNotIn("..", session.save_path)
|
||||
|
||||
await views.upload_chunk(
|
||||
upload_id=upload_id,
|
||||
chunk_index=0,
|
||||
chunk=UploadFile(
|
||||
file=BytesIO(payload), filename="filecodebox.db"
|
||||
),
|
||||
)
|
||||
|
||||
# Simulate a legacy session whose display name was not sanitized.
|
||||
session.file_name = raw_name
|
||||
await session.save(update_fields=["file_name"])
|
||||
|
||||
complete_result = await views.complete_upload(
|
||||
upload_id=upload_id,
|
||||
data=CompleteUploadModel(
|
||||
expire_value=1, expire_style="day"
|
||||
),
|
||||
ip="127.0.0.1",
|
||||
)
|
||||
self.assertEqual(complete_result.detail["name"], "filecodebox.db")
|
||||
|
||||
file_code = await FileCodes.get(code=complete_result.detail["code"])
|
||||
expected_relative_path = session.save_path
|
||||
self.assertEqual(
|
||||
await file_code.get_file_path(), expected_relative_path
|
||||
)
|
||||
storage = views.storages[settings.file_storage]()
|
||||
resolved_path = storage._resolve_safe_path(
|
||||
await file_code.get_file_path()
|
||||
)
|
||||
self.assertEqual(
|
||||
resolved_path, Path(tmpdir.name).resolve() / expected_relative_path
|
||||
)
|
||||
self.assertEqual(resolved_path.read_bytes(), payload)
|
||||
finally:
|
||||
await Tortoise.close_connections()
|
||||
finally:
|
||||
settings.user_config = original_config
|
||||
tmpdir.cleanup()
|
||||
|
||||
|
||||
class AdminJwtUrlSafeTests(unittest.TestCase):
|
||||
def setUp(self):
|
||||
settings.jwt_secret = "j" * 48
|
||||
|
||||