feat: v4.0 managed-user image, egress IP auto-correction, and FK fix

- managed-user image: bump to v4.0.0, use variable user/group names,
  remove v3 version labels from log messages, fix DEV_MODE detection
- egress IP auto-correction: when SOCKS5 probe returns a different IP
  than user-configured ExpectedIP, automatically update egress_ips
  via UpdateEgressIPAddress callback so host creation doesn't fail
  just because the user entered the proxy server IP instead of the
  actual egress IP
- egress-ip-drawer: simplify IP placeholder logic, always use
  0.0.0.0 when user leaves IP blank — backend probe corrects it
- fix: drop FK constraints on host_bypass_snapshots.created_by and
  host_bypass_audit_log.actor_id — audit columns referencing a stale
  user_id (e.g. after DB rebuild) caused all bypass apply/rollback/
  rule operations to fail with 500
- cleanup: normalize comments across entrypoint.sh, Makefile,
  firewall_helpers, container_proxy_provider, and network types

Author: ZaneL1u

.planning/config.json

@@ -26,7 +26,7 @@
     "research_before_questions": false,
     "discuss_mode": "discuss",
     "skip_discuss": false,
-    "_auto_chain_active": true
+    "_auto_chain_active": false
   },
   "hooks": {
     "context_warnings": true

Makefile

@@ -20,8 +20,7 @@ dev: ## Start backend + frontend (auto-starts PostgreSQL if needed)
 	@# Auto-start PostgreSQL if not running
 	@nc -z 127.0.0.1 $(POSTGRES_PORT) > /dev/null 2>&1 || \
 		{ echo "PostgreSQL not running, starting it now..."; $(MAKE) db; }
-	@# v4.0 (Phase 54): sing-box 同容器化后不再需要 sidecar gateway image；
-	@# managed-user 镜像内置 sing-box（Phase 53），非 Linux host 直接跑无需 build。
+	@# managed-user 镜像内置 sing-box，非 Linux host 直接跑无需 build。
 	@trap 'kill $$CP_PID $$VITE_PID 2>/dev/null; wait' INT EXIT; \
 		bash scripts/dev-backend.sh & CP_PID=$$!; \
 		cd web/admin && pnpm dev & VITE_PID=$$!; \

deploy/docker/managed-user/entrypoint.sh

@@ -8,14 +8,12 @@ detect_platform() {
   local testfile="/tmp/.dev_mode_test_$$"
   if ! touch "$testfile" 2>/dev/null || ! chattr +i "$testfile" 2>/dev/null; then
     DEV_MODE=true
+    rm -f "$testfile"
   else
     chattr -i "$testfile" 2>/dev/null || true
     rm -f "$testfile"
     DEV_MODE=false
   fi
-  if [ "$DEV_MODE" = false ] && [ ! -d /sys/class/net/tun0 ] && [ -f /.dockerenv ]; then
-    DEV_MODE=true
-  fi
   readonly DEV_MODE
   echo "[entrypoint] platform: DEV_MODE=$DEV_MODE"
 }
@@ -77,11 +75,10 @@ wait_for_x_display() {
   return 1
 }
 
-# ===== v3.0 stages — D-09 / PITFALLS M4 串行快速失败 =====
 
-prepare_v3_dirs() {
-  echo "[entrypoint] v3: chown /home/claude /workspace-hot /workspace-cold /var/lib/claude-persist"
-  chown -R 1000:1000 \
+prepare_workspace_dirs() {
+  echo "[entrypoint] chown workspace dirs"
+  chown -R "${RUN_USER}:${RUN_USER}" \
     /home/claude \
     /workspace-hot \
     /workspace-cold \
@@ -99,16 +96,16 @@ prepare_persistent_state() {
     cp -an /home/claude/.cache/claude/. "$root/.cache/claude/" 2>/dev/null || true
   fi
 
-  chown -R 1000:1000 "$root"
+  chown -R "${RUN_USER}:${RUN_USER}" "$root" 2>/dev/null || true
 
   rm -rf /home/claude/.claude /home/claude/.cache/claude
   ln -sfn "$root/.claude" /home/claude/.claude
   mkdir -p /home/claude/.cache
   ln -sfn "$root/.cache/claude" /home/claude/.cache/claude
 
-  chown -h 1000:1000 /home/claude/.claude /home/claude/.cache/claude
+  chown -h "${RUN_USER}:${RUN_USER}" /home/claude/.claude /home/claude/.cache/claude 2>/dev/null || true
 
-  echo "[entrypoint] v3: persistent state ready (volume=/var/lib/claude-persist)"
+  echo "[entrypoint] persistent state ready (volume=/var/lib/claude-persist)"
 }
 
 prepare_container_disguise() {
@@ -143,30 +140,29 @@ ENVTELEM
 
 prepare_mergerfs_check() {
   if ! command -v mergerfs >/dev/null 2>&1; then
-    echo "[entrypoint] v3: FATAL mergerfs binary missing" >&2
+    echo "[entrypoint] FATAL mergerfs binary missing" >&2
     exit 1
   fi
   local ver
   ver="$(mergerfs --version 2>&1 | head -n1 || true)"
-  echo "[entrypoint] v3: mergerfs available ($ver) — mount deferred to cloud-claude (Phase 31)"
-  # SC1 / C1 / C2 — documented params for Phase 31 (static traceability):
+  echo "[entrypoint] mergerfs available ($ver) — mount deferred to cloud-claude"
+  # mergerfs params (static traceability):
   #   func.readdir=cor:4,cache.attr=30,cache.entry=30,cache.readdir=true,cache.files=off
   #   category.create=ff, inodecalc=path-hash
   #   2-way: /workspace-hot=RW:/workspace-cold=NC,RO
-  # Q10: CLOUD_CLAUDE_MERGERFS_BRANCHES reserved for Phase 31
-  echo "[entrypoint] v3: mergerfs params (Phase 31): func.readdir=cor:4 category.create=ff inodecalc=path-hash"
+  echo "[entrypoint] mergerfs params: func.readdir=cor:4 category.create=ff inodecalc=path-hash"
 }
 
 assert_tmux_version() {
   local tmux_ver
   tmux_ver="$(tmux -V 2>/dev/null | awk '{print $2}' || true)"
   case "$tmux_ver" in
     3.4*|3.5*|3.6*|3.7*|3.8*|3.9*|[4-9].*)
-      echo "[entrypoint] v3: tmux ${tmux_ver} >= 3.4 ok"
+      echo "[entrypoint] tmux ${tmux_ver} >= 3.4 ok"
       echo "$tmux_ver" >/etc/cloud-claude/tmux.version
       ;;
     *)
-      echo "[entrypoint] v3: FATAL tmux ${tmux_ver} < 3.4" >&2
+      echo "[entrypoint] FATAL tmux ${tmux_ver} < 3.4" >&2
       exit 1
       ;;
   esac
@@ -303,7 +299,7 @@ apply_nft_or_die() {
     if [ -n "$SING_BOX_PID" ]; then kill "$SING_BOX_PID" 2>/dev/null || true; fi
     exit 1
   fi
-  # 清理 v3.x 残留的 ip cloudproxy 表，避免双表 shadow 导致规则不生效
+  # TODO(v5): 清理 v3.x 残留的 ip cloudproxy 表。所有 v3.x 部署迁移完毕后移除此行。
   nft delete table ip cloudproxy 2>/dev/null || true
   if ! nft -f "$NFT_RULESET"; then
     echo "[entrypoint] FATAL: nft 应用失败" >&2
@@ -382,14 +378,13 @@ fi
 if [ "$CONTAINER_USER" != "workspace" ] && id workspace >/dev/null 2>&1; then
   usermod -l "$CONTAINER_USER" workspace
   groupmod -n "$CONTAINER_USER" workspace 2>/dev/null || true
-  # v4.0 (D-53-4): 不再 sed sudoers — v4.0 移除了用户 sudo NOPASSWD 路径。
+  # v4.0: 用户无 sudo 权限（安全基线）
 fi
 
 RUN_USER="${CONTAINER_USER:-workspace}"
 
-# v4.0 (D-53-4): 删除 v3.x 的 sudoers NOPASSWD 写入。
-# 用户拿到 shell 后不再有任何 sudo / root 提权路径。
-# 兜底清理（防御历史镜像残留 / volume 挂载的 sudoers.d）：
+# v4.0: 用户无 sudo 权限。兜底清理历史镜像残留的 sudoers.d：
+# TODO(v5): 移除此 v3.x sudoers 兜底清理。
 rm -f /etc/sudoers.d/workspace 2>/dev/null || true
 if [ "${RUN_USER}" != "workspace" ]; then
   rm -f "/etc/sudoers.d/${RUN_USER}" 2>/dev/null || true
@@ -408,7 +403,7 @@ fi
 
 echo "${RUN_USER}:${CONTAINER_PASSWORD}" | chpasswd
 
-# Phase 29.1: 验证密码已被成功设置，避免"密码退化为 workspace"的静默失败复现。
+# 验证密码已被成功设置，避免"密码退化为 workspace"的静默失败复现。
 # passwd -S 第 2 列语义：P / PS = 已设置密码；L / LK = 已锁定；NP = 无密码；UNSET = 读取失败。
 status="$(passwd -S "${RUN_USER}" 2>/dev/null | awk '{print $2}' || echo UNSET)"
 case "$status" in
@@ -575,19 +570,13 @@ su "${RUN_USER}" -c 'DISPLAY=:99 HOME=/workspace pcmanfm --desktop --profile def
 # 预热一遍 Chromium 检测，方便排查图标点击失败。
 su "${RUN_USER}" -c 'HOME=/workspace /usr/local/bin/launch-chromium.sh --version' >>"${CHROMIUM_LOG}" 2>&1 || true
 
-# ===== v3.0 stages (serialized fail-fast, D-09 order) =====
-prepare_v3_dirs
+prepare_workspace_dirs
 prepare_persistent_state
 prepare_container_disguise
 prepare_mergerfs_check
 assert_tmux_version
 
 fi # end MODE != "local"
 
-# v4.0 (Phase 53): 旧的 MODE=local sing-box 分支已删除。
-# 出网现在由顶部 start_singbox_or_die / apply_nft_or_die 序列统一处理，
-# 所有 MODE 都强制走 sing-box tun + nft default-deny，没有 proxy fallback。
-# 用户的 ALL_PROXY / HTTP_PROXY 环境变量也不再注入（应用应直接走 tun）。
-
 # Foreground: sshd
 exec /usr/sbin/sshd -D -e

deploy/docker/managed-user/image.lock

@@ -8,7 +8,7 @@ default_user: workspace
 rebuild_mode_default: preserve-home
 factory_reset_mode: wipe-/workspace
 # v3.0 baseline — Phase 29 追加
-image_version: v3.3.0
+image_version: v4.0.0
 mergerfs_version: 2.41.1
 tmux_version_min: "3.4"
 supports_mergerfs: true

internal/controlplane/http/admin_egress_ip_probe.go

@@ -22,8 +22,7 @@ import (
 	"golang.org/x/net/proxy"
 )
 
-// probeImage 固定 sing-box 版本，与项目自建 gateway 镜像保持一致（v1.13.3），
-// 避免 latest 版本配置格式不兼容导致探针失败。
+// probeImage 固定 sing-box 版本（v1.13.3），避免 latest 版本配置格式不兼容导致探针失败。
 const probeImage = "ghcr.io/sagernet/sing-box:v1.13.3"
 
 type ProbeResult struct {

internal/network/container_proxy_provider.go

@@ -38,7 +38,7 @@ func NewContainerProxyProvider(logger *slog.Logger, verifier NetworkVerifier) *C
 // v4.0 (Phase 54) 改造（54-01）：
 //   - 不再创建 cloudproxy-net-* 自定义 bridge（删除 dockerNetworkCreate 调用）
 //   - 不再启动 sidecar gateway 容器（删除 dockerRunGateway / waitGatewayHealthy）
-//   - 不再写 v3.5 容器 DNS 入口锁占位（resolv.conf / nsswitch.conf 由容器内 sing-box
+//   - 不再写容器 DNS 入口锁占位（resolv.conf / nsswitch.conf 由容器内 sing-box
 //     接管，删除 WriteContainerDNSConfig 调用）
 //   - 不再写 v4 sing-box 路径下的 cidrs / domains placeholder（由 sing-box config
 //     的 route.rule_set 直接拉取，54-02 决定具体格式）

internal/network/firewall_helpers.go

@@ -169,7 +169,7 @@ func addIifTCPDportAcceptRule(conn *nftables.Conn, table *nftables.Table, chain
 	})
 }
 
-// ----- Phase 47 Plan 02: v3.5 bypass-firewall helpers ----------------------
+// ----- bypass-firewall helpers ---------------------------------------------
 //
 // 这一组 helper 把 4 类新规则的 expr 序列构造抽成纯函数（buildXxxExprs），
 // 再由配套的 addXxxRule wrapper 负责 conn.AddRule(...) 真实下发。

internal/network/types.go

@@ -1,6 +1,7 @@
 package network
 
 import (
+	"context"
 	"encoding/json"
 )
 
@@ -20,6 +21,11 @@ type EgressConfig struct {
 	ExpectedIP string     // expected egress IP address (e.g. "1.2.3.4")
 	TunnelType string     // "proxy"
 	Proxy      *ProxySpec // proxy config
+
+	// UpdateExpectedIP 为可选的出口 IP 自动纠正回调。
+	// 当 SOCKS5 探测一致返回与 ExpectedIP 不同的 IP 时，verifier 调用此回调
+	// 更新 egress_ips.ip_address，避免因用户填错代理服务器 IP 导致创建失败。
+	UpdateExpectedIP func(ctx context.Context, newIP string) error
 }
 
 // HostNetworkSpec carries everything the network Provider needs to wire a container.
@@ -29,13 +35,9 @@ type HostNetworkSpec struct {
 	Egress       *EgressConfig // nil when Provider should skip network setup
 }
 
-// BypassSingboxUID 是 gateway 容器内 sing-box 进程的 uid（与 sing-gateway Dockerfile 对齐）。
-// 在 worker netns 的 nft output 链做 uid 锁：仅该 uid 能 TCP 连到代理服务器 IP:443。
-// 注意：worker netns 与 gateway netns 是两个 namespace，meta skuid 匹配的是
-// worker 容器内的进程 uid。v3.5 设计下 sing-box 跑在 gateway 容器，worker 容器内
-// 没有 sing-box，故 uid 锁实际作用是：worker 容器内任何 uid 都不能直连代理服务器
-// （除非通过 sb-tun0），这是 fail-closed 的最强形态。暴露该常量是为了未来如果切到
-// sidecar 同 netns 模式时保持单点变更。
+// BypassSingboxUID 是容器内 sing-box 进程的 uid（与 Dockerfile 对齐）。
+// uid 锁确保仅 sing-box 能直连代理服务器，其余进程 uid 一律走 tun0。
+// 暴露该常量是为了未来如果切到同 netns 模式时保持单点变更。
 const BypassSingboxUID uint32 = 1000
 
 // BypassNftSetName 是 worker netns nft inet 表内白名单 set 的名字。

internal/network/verify.go

@@ -179,6 +179,12 @@ func VerifyNetworkIntegrityDocker(ctx context.Context, containerName string, exp
 		result.BypassEgressOK = true
 		result.NonBypassEgressOK = true
 
+		if result.ActualEgressIP != "" && result.ActualEgressIP != expected.ExpectedIP && expected.UpdateExpectedIP != nil {
+			if err := expected.UpdateExpectedIP(ctx, result.ActualEgressIP); err == nil {
+				expected.ExpectedIP = result.ActualEgressIP
+				verifyEgressIPMultiSOCKS(ctx, prefix, expected.ExpectedIP, egressIPSources, &result)
+			}
+		}
 		lastErr = firstNetworkError(expected, result)
 		if result.AllPassed() {
 			return result, nil

internal/runtime/tasks/ssh_inject_test.go

@@ -107,6 +107,10 @@ func (r *fakeWorkerRepo) GetLatestAppliedBypassSnapshot(_ context.Context, _ str
 	return repository.BypassSnapshot{}, nil
 }
 
+func (r *fakeWorkerRepo) UpdateEgressIPAddress(_ context.Context, _ string, _ string) error {
+	return nil
+}
+
 // setupInjectTest 装配 fake 容器、fake repo、代理公钥与 execInContainer 注入点，
 // 返回 worker + 容器 + repo，供测试断言。
 func setupInjectTest(t *testing.T, proxyPub string) (*Worker, *fakeContainer, *fakeWorkerRepo) {