Release 0.3.6

Make upload size unlimited by default while keeping optional upload limits. Add a Simplified Chinese README and document bilingual README maintenance.

Author: freelamb

AGENTS.md

@@ -22,7 +22,7 @@ Treat this project as a temporary file-sharing tool for trusted environments. It
 - Adds an HTML upload form to directory listings.
 - Stores uploaded files in the requested directory after sanitizing the uploaded filename.
 - Avoids overwriting existing files by appending `_` to the target filename.
-- Rejects uploads larger than the configured upload limit; the default is 100 MiB and can be raised with `--max-upload-size MIB`.
+- Does not limit upload size by default; `--max-upload-size MIB` can set an explicit limit.
 - Uses Python standard library modules only.
 
 ## Important Implementation Notes
@@ -46,8 +46,8 @@ When making changes, prioritize these issues first:
 3. Preserve safer network defaults.
    The default bind address is `127.0.0.1`; document `0.0.0.0` as an explicit LAN/public option.
 
-4. Maintain upload limits.
-   Large or slow uploads can exhaust disk, memory, or worker capacity. The current limit is 100 MiB.
+4. Keep upload size behavior explicit.
+   Large or slow uploads can exhaust disk, memory, or worker capacity. The default is currently unlimited; document any limit changes clearly and keep `--max-upload-size` behavior covered by tests.
 
 5. Improve request robustness.
    Handle missing `Content-Type`, missing `content-length`, malformed multipart bodies, and interrupted uploads without crashing the server.
@@ -105,7 +105,8 @@ Keep these files aligned:
 
 - `simple_http_server.py`: source version in `__version__`.
 - `CHANGELOG.md`: released changes.
-- `README.md`: install, run, Docker, support status, and security caveats.
+- `README.md`: English install, run, Docker, support status, and security caveats.
+- `README.zh-CN.md`: Simplified Chinese translation of `README.md`; update it whenever the English README changes.
 - `SECURITY.md`: supported versions and vulnerability contact.
 - `.github/workflows/github-actions-test.yml`: supported Python versions and CI checks.
 

CHANGELOG.md

@@ -1,3 +1,10 @@
+<a name="0.3.6"></a>
+## [0.3.6] (2026-06-03)
+### Features
+
+* make upload size unlimited by default while keeping optional `--max-upload-size`
+* add a Simplified Chinese README and language links between README files
+
 <a name="0.3.5"></a>
 ## [0.3.5] (2026-06-03)
 ### Features

README.md

@@ -1,5 +1,7 @@
 # simple_http_server
 
+[English](README.md) | [简体中文](README.zh-CN.md)
+
 ## Features
 
 - ✔ simple
@@ -19,7 +21,7 @@ $ cd simple_http_server
 # run server
 $ python simple_http_server.py 8000
 
-# allow upload requests up to 1 GiB
+# optionally limit upload requests to 1 GiB
 $ python simple_http_server.py --max-upload-size 1024 8000
 
 # expose to another host in a trusted network
@@ -49,7 +51,7 @@ docker run
 
 This server is intended for temporary file sharing in trusted environments. The default bind address is `127.0.0.1`; use `--bind 0.0.0.0` only when you explicitly want other hosts to connect.
 
-Uploaded file names are sanitized, upload results and directory listings escape user-controlled text, and upload requests larger than 100 MiB are rejected by default. Use `--max-upload-size MIB` to raise that limit in trusted environments.
+Uploaded file names are sanitized, and upload results and directory listings escape user-controlled text. Upload size is unlimited by default; use `--max-upload-size MIB` to set a limit when you need one in trusted environments.
 
 ## Example
 

README.zh-CN.md

@@ -0,0 +1,84 @@
+# simple_http_server
+
+[English](README.md) | [简体中文](README.zh-CN.md)
+
+## 功能
+
+- 简单易用
+- 支持上传
+- 支持批量上传
+- 支持下载
+- 支持 Python 2 和 Python 3
+- 支持多线程
+
+## 使用方法
+
+```bash
+# 获取代码
+$ git clone https://github.com/freelamb/simple_http_server.git
+
+# 进入目录
+$ cd simple_http_server
+
+# 启动服务
+$ python simple_http_server.py 8000
+
+# 可选：将上传请求限制为 1 GiB
+$ python simple_http_server.py --max-upload-size 1024 8000
+
+# 在可信网络中允许其他主机访问
+$ python simple_http_server.py --bind 0.0.0.0 8000
+```
+
+发布版本后，可以从 PyPI 安装：
+
+```bash
+$ python -m pip install simple-http-server-upload
+$ simple-http-server-upload 8000
+```
+
+```bash
+# 作为 Docker 容器运行
+# 1. 构建镜像（下面的 "." 表示项目根目录）
+docker build -t freelamb/simple_http_server .
+
+# 2. 使用刚刚构建的镜像启动容器
+docker run
+  --name simple_http_server \
+  -p 8000:8000 \
+  -v /opt/data:/opt/data \
+  -d freelamb/simple_http_server:latest
+```
+
+## 安全说明
+
+这个服务用于可信环境中的临时文件共享。默认绑定地址是 `127.0.0.1`；只有在明确希望其他主机连接时，才使用 `--bind 0.0.0.0`。
+
+上传文件名会被清理，上传结果和目录列表会对用户可控文本做 HTML 转义。上传大小默认不设上限；如需限制上传大小，可以在可信环境中使用 `--max-upload-size MIB`。
+
+## 示例
+
+![](image/example.jpeg)
+
+## 待办
+
+- [ ] 添加 Docker 镜像
+
+## 贡献
+
+1. 检查已有 issue，或新建 issue 来讨论功能想法或问题。
+2. 在 GitHub 上 fork [本仓库](https://github.com/freelamb/simple_http_server)，从 **master** 分支开始修改，或基于它创建新分支。
+3. 编写测试，证明问题已经修复，或功能符合预期。
+4. 提交 pull request，并持续跟进直到合并和发布。记得把自己添加到 [AUTHORS](AUTHORS.md)。
+
+## 更新日志
+
+[更新日志](CHANGELOG.md)
+
+## 参考
+
+<https://github.com/tualatrix/tools/blob/master/SimpleHTTPServerWithUpload.py>
+
+## 许可证
+
+[MIT](https://tldrlegal.com/license/mit-license)

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "simple-http-server-upload"
-version = "0.3.5"
+version = "0.3.6"
 description = "A small HTTP file server with directory browsing and uploads."
 readme = "README.md"
 requires-python = ">=3.9"

simple_http_server.py

@@ -6,7 +6,7 @@
 and HEAD requests in a fairly straightforward manner.
 """
 
-__version__ = "0.3.5"
+__version__ = "0.3.6"
 __author__ = "yangyongbao@126.com"
 __all__ = ["SimpleHTTPRequestHandler"]
 
@@ -47,8 +47,8 @@ class ThreadingHTTPServer(ThreadingMixIn, BaseHTTPServer):
 
 
 BYTES_PER_MIB = 1024 * 1024
-DEFAULT_MAX_UPLOAD_SIZE_MIB = 100
-MAX_UPLOAD_SIZE = DEFAULT_MAX_UPLOAD_SIZE_MIB * BYTES_PER_MIB
+DEFAULT_MAX_UPLOAD_SIZE_MIB = None
+MAX_UPLOAD_SIZE = None
 
 try:
     CONNECTION_ERRORS = (ConnectionResetError, ConnectionAbortedError, BrokenPipeError)
@@ -124,6 +124,8 @@ def do_POST(self):
             f.close()
 
     def is_upload_too_large(self):
+        if self.max_upload_size is None:
+            return False
         content_length = self.headers.get('content-length')
         if not content_length:
             return False
@@ -149,7 +151,7 @@ def deal_post_data(self):
             return False, "Invalid content-length header"
         if remain_bytes < 0:
             return False, "Invalid content-length header"
-        if remain_bytes > self.max_upload_size:
+        if self.max_upload_size is not None and remain_bytes > self.max_upload_size:
             return False, "Upload exceeds the %d byte limit" % self.max_upload_size
 
         remain_bytes_value = [remain_bytes]
@@ -443,7 +445,7 @@ def positive_int(value):
 def _argparse():
     parser = argparse.ArgumentParser()
     parser.add_argument('--bind', '-b', metavar='ADDRESS', default='127.0.0.1', help='Specify alternate bind address [default: 127.0.0.1]')
-    parser.add_argument('--max-upload-size', metavar='MIB', default=DEFAULT_MAX_UPLOAD_SIZE_MIB, type=positive_int, help='Maximum upload request size in MiB [default: 100]')
+    parser.add_argument('--max-upload-size', metavar='MIB', default=DEFAULT_MAX_UPLOAD_SIZE_MIB, type=positive_int, help='Maximum upload request size in MiB [default: unlimited]')
     parser.add_argument('--version', '-v', action='version', version=__version__)
     parser.add_argument('port', action='store', default=8000, type=int, nargs='?', help='Specify alternate port [default: 8000]')
     return parser.parse_args()
@@ -452,7 +454,10 @@ def main():
     args = _argparse()
     # print(args)
     server_address = (args.bind, args.port)
-    SimpleHTTPRequestHandler.max_upload_size = args.max_upload_size * BYTES_PER_MIB
+    if args.max_upload_size is None:
+        SimpleHTTPRequestHandler.max_upload_size = None
+    else:
+        SimpleHTTPRequestHandler.max_upload_size = args.max_upload_size * BYTES_PER_MIB
     signal.signal(signal.SIGINT, signal_handler)
     signal.signal(signal.SIGTERM, signal_handler)
     httpd = ThreadingHTTPServer(server_address, SimpleHTTPRequestHandler)

tests/test_simple_http_server.py

@@ -199,7 +199,7 @@ def test_default_bind_is_localhost(self):
             sys.argv = old_argv
         self.assertEqual(args.bind, "127.0.0.1")
         self.assertEqual(args.port, 8000)
-        self.assertEqual(args.max_upload_size, 100)
+        self.assertIsNone(args.max_upload_size)
 
     def test_custom_max_upload_size(self):
         old_argv = sys.argv
@@ -242,12 +242,21 @@ def raise_disconnect(_self):
 
 
 class UploadLimitTests(unittest.TestCase):
-    def test_large_upload_is_reported_as_too_large(self):
+    def test_upload_size_is_unlimited_by_default(self):
         handler = simple_http_server.SimpleHTTPRequestHandler.__new__(
             simple_http_server.SimpleHTTPRequestHandler
         )
-        handler.headers = {'content-length': str(simple_http_server.MAX_UPLOAD_SIZE + 1)}
-        handler.max_upload_size = simple_http_server.MAX_UPLOAD_SIZE
+        handler.headers = {'content-length': str(1024 * 1024 * 1024 * 10)}
+        handler.max_upload_size = None
+
+        self.assertFalse(handler.is_upload_too_large())
+
+    def test_configured_large_upload_is_reported_as_too_large(self):
+        handler = simple_http_server.SimpleHTTPRequestHandler.__new__(
+            simple_http_server.SimpleHTTPRequestHandler
+        )
+        handler.headers = {'content-length': str((100 * simple_http_server.BYTES_PER_MIB) + 1)}
+        handler.max_upload_size = 100 * simple_http_server.BYTES_PER_MIB
 
         self.assertTrue(handler.is_upload_too_large())