Linux文件句柄限制由单进程软/硬限制、用户级默认限制、系统全局上限三层共同控制，任一层不足均会导致“Too many open files”错误，需逐层排查并协同优化。

Linux 文件句柄限制不是改一个地方就能生效的，它由三层机制共同控制：单进程软/硬限制、用户级默认限制、系统全局上限。任一层卡住，服务仍会报 “Too many open files” 错误。

查清当前三层限制值

动手前先确认现状，避免盲目修改：

• 当前 Shell 的软硬限制：ulimit -Sn（软）和 ulimit -Hn（硬）
• 系统总上限：cat /proc/sys/fs/file-max
• 单进程理论天花板：cat /proc/sys/fs/nr_open（hard limit 不能超过此值）
• 某个进程实际用了多少句柄：ls -l /proc/<PID>/fd | wc -l

逐层设置用户级文件句柄限制

这一层影响所有以该用户身份启动的进程（如 Nginx worker、Java 应用），但需注意 PAM 和登录方式：

Browser Setup (No-Root Linux)

在无 root/sudo 权限的环境（云容器、VPS、隔离主机）中安装并配置 OpenClaw 浏览器工具的 headless Chrome。适用场景：...

下载

• 编辑 /etc/security/limits.conf，添加两行（以通配符为例）：
  * soft nofile 65535
  * hard nofile 1048576
• 确保 PAM 加载模块：检查 /etc/pam.d/common-session 是否含 session required pam_limits.so，没有就加上
• 对 systemd 服务（如 Redis、Nginx），limits.conf 默认不生效，必须在 service 文件中显式配置：
  LimitNOFILE=65535
• 修改后需完全退出当前终端并新建登录会话（su 或 sudo -i 不触发 PAM limits）

调高系统级全局上限

这是内核能分配的文件描述符总数，要大于「并发连接数 × 平均每进程句柄数」再加 20% 余量：

• 临时生效：sudo sysctl -w fs.file-max=2097152
• 永久生效：向 /etc/sysctl.conf 追加一行：
  fs.file-max = 2097152
• 立即加载：sudo sysctl -p
• 若需设更高 hard limit（如 200 万），先确认并可能提升 fs.nr_open：
  echo "fs.nr_open = 2097152" | sudo tee -a /etc/sysctl.conf && sudo sysctl -p

关联内核参数协同优化

有些参数虽不直接限制数量，但影响句柄分配效率与稳定性：

• 提升 inotify 监控能力（适用于文件监听类服务）：
  fs.inotify.max_user_watches = 524288
• 增大异步 I/O 队列（适配 AIO 应用）：
  fs.aio-max-nr = 1048576
• 调整 TCP TIME_WAIT 行为（缓解端口耗尽）：
  net.ipv4.tcp_tw_reuse = 1
  net.ipv4.tcp_fin_timeout = 30
• 所有上述参数都写入 /etc/sysctl.conf 后执行 sudo sysctl -p 生效