深入了解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的值，希望可以對你解決實時文件監測問題提供幫助。