您的位置:

深入了解fs.inotify.max_user_watches

一、max_user_watches是什么

在Linux系统中,inotify 机制支持应用程序监视文件系统中的事件,如果你的应用程序监视了大量的文件和目录,很可能会遇到监视文件夹数到达上限的问题,这时候你就需要向系统调整Linux内核参数fs.inotify.max_user_watches来解决。

内核调用inotify_init函数获取inotify实例时,该实例会占用一个文件描述符。文件描述符是有限资源,内核对能够打开的文件描述符数量有限制,这个限制就是以fs.inotify.max_user_watches参数的形式存在的。

默认情况下,fs.inotify.max_user_watches的值是8192,系统内存大小不同,值也会发生变化。这个内核参数设定的是单个用户可以使用监视的文件或目录总数上限,而不是配置单个了对应的监视事件上限。也就是说,如果系统中有多个用户同时使用监视功能,fs.inotify.max_user_watches 的上限会更实在。

二、调整max_user_watches

可以通过以下两种方式来临时和永久更改max_user_watches的值:

1. 临时更改

你可以尝试在终端中,使用echo命令来更改该参数:

sudo echo 524288 > /proc/sys/fs/inotify/max_user_watches

这里,我们将max_user_watches更改为524288。

这种方式更改并不是永久性的,只会在本次终端退出前生效。如果你希望永久修改该参数,就可以使用下面的方式。

2. 永久更改

打开sysctl.conf文件来更改max_user_watches的值,这是永久性的方式。

使用文本编辑器打开 /etc/sysctl.conf,将下面的一行添加到该文件末尾

fs.inotify.max_user_watches=524288

保存文件,然后在终端中使用下面的命令使新设置立即生效:

sudo sysctl -p

这条命令将重新读取sysctl.conf,并使更改生效。 (请注意,更改可能要求您以root身份运行命令)

三、一些应用案例

1. webpack-dev-server

当你使用webpack-dev-server作为应用服务器时,可能经常会遇到 max_user_watches 的问题。官方的解决方式是修改fs.inotify.max_user_watches参数的值, 使其大于webpack-dev-server监听的文件数,例如:

echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p

这样可以使得您在开发时不会遇到 max_user_watches 的限制问题。

2. VSCode

当你打开一个文件夹或者工程时,如果这个目录中的文件或者子目录比较多,你可能会遇到 "ENOSPC" 的错误提示。如果你使用的是VSCode,你可以尝试在设置节目中增加如下配置:

"files.watcherExclude": {
  "**/.git/objects/**": true,
  "**/.git/subtree-cache/**": true,
  "**/node_modules/*/**": true,
  "**/venv/**": true,
  "**/.mypy_cache/**": true
}

这个配置可以让VSCode对指定的文件或目录不执行文件监测,降低目录下文件数而导致的事件监测最大数目。

3. Docker

当你在Docker容器中安装Docker应用程序时,可能会遇到max_user_watches的限制。这是因为默认情况下Docker容器的文件系统是只读的,建议在构建Docker镜像的时候,添加如下配置:

RUN echo fs.inotify.max_user_watches=524288 | tee -a /etc/sysctl.conf && sysctl -p

这个方法是使得每个Docker容器配置fs.inotify.max_user_watches,检测文件的数量范围也更大。

4. Node.js

Node.js也可能出现实时文件监测数量过多的问题,你可以尝试运行以下代码解决:

echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p

这条命令为nodejs配置fs.inotify.max_user_watches,解决 Node.js 应用程序动态处理的触发事件数太大的问题。

总结

无论是哪个领域的应用程序,当涉及到监听文件或目录,文件数和子目录的数量就是个关键因素。但总有一种方法会解决问题,本文详细的介绍了如何调整fs.inotify.max_user_watches的值,希望可以对你解决实时文件监测问题提供帮助。