docs(gateway): 更正扫描线程「必须在 worker 期 spawn」的理由

共享内存是 MAP_SHARED 映射,锁字是共享的而不是 fork 时复制的 ⇒ 子进程不会
「继承一份私有副本的已锁状态」。真正的理由是 .so 数据段里的 Rust OnceLock
在 fork 时是私有副本 ⇒ master 期 spawn 会让每个 worker 都命中「已初始化」
而根本不起线程。结论不变(仍必须 worker 期 spawn)。

Co-Authored-By: Claude Opus 5.5 <[email protected]>
This commit is contained in:
adminandClaude Opus 5.5 committed 2026-11-11 01:34:01 +08:00
1 parent fe32751d92
commit 5df7ca1076
1 file changed
+5 -2
+5 -2
View File
@@ -498,8 +498,11 @@ unsafe extern "C" fn init_process(_cycle: *mut ngx_cycle_t) -> ngx_int_t {
Ok(false) => {}
Err(e) => util::log_err(&format!("[ipass] 初始化管理员失败: {e}")),
}
// users.json 变更自动生效:后台扫描线程(必须在 worker 期 spawn ——
// master 期 fork 会把持锁状态带进子进程,见 reloader.rs 顶部注释)
// users.json 变更自动生效:后台扫描线程(**必须在 worker 期 spawn** ——
// 共享内存是 MAP_SHARED,锁**不会**随 fork 复制成私有副本;真正的理由是
// .so 数据段里的 Rust OnceLock(SPAWNED)在 fork 时是私有副本 ⇒ master 期
// spawn 会让每个 worker 都命中「已初始化」而**根本不起线程**、特性静默失效。
// 见 reloader.rs 顶部注释)
ipass_core::reloader::worker_spawn();
// 对话审计:确保目录存在 + 容量巡检一次(此后由请求写入节流触发)
ipass_plugin_llm::llm_audit::startup();