From efbfce99e7a11efe9917a87b8b6cf625d9ddba20 Mon Sep 17 00:00:00 2001 From: mole404 <248403041+mole404@users.noreply.github.com> Date: Fri, 2 Oct 2026 15:45:58 +0800 Subject: [PATCH] Update README.md --- README.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 2a5664d..46433e5 100644 --- a/README.md +++ b/README.md @@ -11,7 +11,6 @@ ## 特性 - **开箱即用**:默认用 SQLite,不需要额外跑一个数据库服务;容器起来后浏览器打开就是安装向导。 -- **版本可追溯**:每次构建都会发布一个永不变化的 `sha-` 镜像,随时能回到任意历史版本,不怕"最新版翻车回不去"。 - **低配友好**:默认的 Web 服务并发参数是按小内存服务器调过的,也都可以用环境变量单项覆盖。 - **安全加固**:登录/注册等认证接口有限流,不采信客户端伪造的转发头,移除了 SVG 上传,并升级了一批带 CVE 的依赖。 - **界面清爽**:整套前端重做过,简洁风格 + 亮色/暗色/跟随系统。 @@ -51,7 +50,7 @@ docker run -d --name lsky-pro --restart unless-stopped \ ### 首次安装 -1. 容器起来后访问 `http://<主机>:8089/`,会自动跳到安装向导。 +1. 容器首次部署后访问 `http://<主机>:8089/`,会自动跳到安装向导,**更推荐设置反代**。 2. 按向导填写数据库(默认 SQLite,镜像自带驱动)与管理员账号。 3. 安装结果写进卷里的 `.env` 与 `database/`。 @@ -61,7 +60,7 @@ docker run -d --name lsky-pro --restart unless-stopped \ ```bash docker compose pull -docker compose up -d # 不需要 --force-recreate +docker compose up -d ``` --- @@ -75,11 +74,11 @@ docker compose up -d # 不需要 --force-recreate | `WEB_PORT` | `8089` | 容器内 Web 服务的 HTTP 端口 | | `HTTPS_PORT` | `8088` | 容器内 HTTPS 端口(自签证书,仅供内网调试) | -自签证书不随镜像发货、也不进数据卷:每个容器首次启动自己生成。想用自己的证书,把 `.crt` / `.key` 挂到容器内 `/etc/apache2/ssl/lsky-selfsigned.crt` 与 `.key` 覆盖即可。 +自签证书不随镜像发放、也不进数据卷:每个容器首次启动自己生成。想用自己的证书,把 `.crt` / `.key` 挂到容器内 `/etc/apache2/ssl/lsky-selfsigned.crt` 与 `.key` 覆盖即可。 -### 并发与内存(低配机器重点看) +### 并发与内存 -镜像内置一套面向小内存单用户的参数。每一项都能用环境变量单独覆盖,写哪个改哪个: +镜像默认内置一套面向小内存单用户的参数。每一项都能用环境变量单独覆盖: | 环境变量 | 默认值 | 说明 | | --- | --- | --- | @@ -90,7 +89,8 @@ docker compose up -d # 不需要 --force-recreate | `APACHE_MAX_CONNECTIONS_PER_CHILD` | `5` | 单个子进程处理多少个请求后回收(`0` = 永不回收) | | `APACHE_KEEP_ALIVE` | `Off` | 只接受 `On` / `Off`;`Off` 最省内存 | -取值按「一个 Web 子进程跑起应用后 ≈ 30–50MB」估算,让 `MaxRequestWorkers × 单进程内存 ≤ 机器可用内存`,宁小勿大 —— 并发开太大被系统 OOM 杀掉,比多排一会儿队糟得多。写了非法值只会把那一项退回默认并在日志里警告,不会让容器起不来。 +如果您不知道这些参数起什么作用,请不要随意修改,否则有爆内存风险。 +面向个人自用以上参数保持默认值即可,多用户场景下可增大。 ---