绿联NAS如何用命令行建立可见共享文件夹

📺 本图文教程由视频整理而成，对应的参考视频：绿联NAS通过命令行创建文件夹无法正常显示～了解文件夹扩展属性即可轻松解决。如需查看更详细、更具体的操作演示，可观看原视频。

场景：绿联 NAS 借鉴了群晖的部分权限管理机制，引入了「共享文件夹」机制。结果是：你用命令行（或用 Docker Compose、懒人包）自动创建的文件夹，不会出现在绿联文件管理器的「共享文件夹」里，新手常常一头雾水。本文先复现问题、再对比差异，最后给出只需一次操作即可让文件夹正常显示的解决方法；文末还附上懒人包默认目录（media / downloads / netdisk）的补救处理。

提示：本教程配套的操作文档，可在好用斋官网 → 网盘分享（提取码 492）中下载。

第一步：用命令行建立测试文件夹（复现问题）

先用命令行建立一个测试目录，观察它是否可见。共享文件夹都位于 /volume1 目录下：

bash

mkdir -p /volume1/test

参数说明：mkdir 表示建立目录，-p 表示目录已存在就跳过、不存在才创建。

接着打开绿联的终端，获取管理员权限：

输入 sudo -i 并回车。
输入管理员密码。注意：密码输入时不显示，输完直接回车即可。
提示符从 haoyong 变为 root，说明已拿到管理员权限。

bash

sudo -i
mkdir -p /volume1/test
cd /volume1
ls

执行 ls 可以看到，/volume1 下确实多出了 test 文件夹。但回到绿联云客户端的「文件管理 → 共享文件夹」，里面只有一个默认的 docker 文件夹，我们新建的 test 并没有显示——这就是问题的现象。

命令行建立的 test 文件夹在「共享文件夹」中并不显示

第二步：用图形界面建立对照文件夹 test2

为找出差异，再用图形界面建立一个同样用于测试的共享文件夹。

在「文件管理 → 共享文件夹」中点击「+」。
选择「新建共享文件夹」，名称填 test2。
点击「创建」，权限保持默认，点击「确定」。

可以看到，图形界面创建的文件夹能正常显示，命令行创建的却不行。把这两者的差异找出来，问题就解决了一半。

第三步：对比二者的扩展属性

使用 getfattr 查看目录（文件夹）的扩展属性：

bash

# 查看图形界面创建的 test2
getfattr -d /volume1/test2

# 对比命令行自建的 test
getfattr -d /volume1/test

参数说明：-d 表示查看所有属性，后面接具体的文件夹路径。

查询结果对比非常直观：

test2 有 5 个扩展属性。
test 没有任何扩展属性。

test2 有 5 个扩展属性，而命令行自建的 test 没有任何扩展属性

结论：只要给自建文件夹补上 test2 那 5 个相同的扩展属性，就能被系统识别。

第四步：为自建文件夹补齐扩展属性（核心操作）

把 get 换成 set 即可设置属性：-n 表示属性名（name），-v 表示属性值（value），最后是具体目录。值要与第三步中 test2 查出来的值一一对应：

bash

setfattr -n user.allow_only_admin_recycle.status -v "true" /volume1/test
setfattr -n user.data_check.status -v "false" /volume1/test
setfattr -n user.network_places_hide.status -v "false" /volume1/test
setfattr -n user.no_permission_hide.status -v "true" /volume1/test
setfattr -n user.share_folder_key.type -v "1" /volume1/test

执行完后可以复查一下，确认与 test2 属性一致：

bash

getfattr -d /volume1/test

尽管真正针对「不可见」问题的可能只是其中个别参数，但既然共有 5 个属性不同，就一次性把 5 个全部设置上去，保证使用时不出现其它异常。

注意

自建文件夹必须补齐与图形界面文件夹完全一致的 5 个扩展属性，再重启系统才能被识别为共享文件夹；只改部分属性可能留下隐患。

第五步：处理懒人包默认创建的目录（可选）

如果你曾用 Docker 懒人包部署，它会默认创建 media、downloads、netdisk 等目录；在懒人包运行之前先用图形界面建好这些目录，本就是推荐做法。若当初忘了、直接跑了懒人包，也可以用本方法补救——这些目录同样不可见，同样补上 5 个扩展属性即可：

bash

# media
setfattr -n user.allow_only_admin_recycle.status -v "true" /volume1/media
setfattr -n user.data_check.status -v "false" /volume1/media
setfattr -n user.network_places_hide.status -v "false" /volume1/media
setfattr -n user.no_permission_hide.status -v "true" /volume1/media
setfattr -n user.share_folder_key.type -v "1" /volume1/media

# downloads
setfattr -n user.allow_only_admin_recycle.status -v "true" /volume1/downloads
setfattr -n user.data_check.status -v "false" /volume1/downloads
setfattr -n user.network_places_hide.status -v "false" /volume1/downloads
setfattr -n user.no_permission_hide.status -v "true" /volume1/downloads
setfattr -n user.share_folder_key.type -v "1" /volume1/downloads

# netdisk
setfattr -n user.allow_only_admin_recycle.status -v "true" /volume1/netdisk
setfattr -n user.data_check.status -v "false" /volume1/netdisk
setfattr -n user.network_places_hide.status -v "false" /volume1/netdisk
setfattr -n user.no_permission_hide.status -v "true" /volume1/netdisk
setfattr -n user.share_folder_key.type -v "1" /volume1/netdisk

第六步：重启系统使设置生效

扩展属性已写入，最后重启一次绿联 NAS 让其重新识别：

命令行输入 reboot 重启；或
点击右上角「个人中心 → 重新启动」。

bash

reboot

重启完成后，打开「文件管理 → 共享文件夹」，此前自建的 test 以及懒人包创建的 media、downloads、netdisk 都会正常显示，问题圆满解决。

扩展属性参数说明

扩展属性	取值	含义
`user.allow_only_admin_recycle.status`	`true`	控制回收站行为。`true` 表示只有管理员能使用回收站；`false` 表示普通用户删除文件也会进回收站。
`user.data_check.status`	`false`	与数据校验（Data Scrubbing / 完整性检查）相关。`false` 表示不针对此目录特殊启用定期校验。
`user.network_places_hide.status`	`false`	是否在网络位置（网上邻居、SMB 浏览列表）中隐藏。`false` 表示正常显示。
`user.no_permission_hide.status`	`true`	无权限时是否隐藏该文件夹。`true` 表示无权限用户完全看不到，更安全。
`user.share_folder_key.type`	`1`	标识该目录为系统「共享文件夹」类型，用于系统识别。

总结

问题的根源：绿联的共享文件夹需要特定的扩展属性才会在文件管理器中显示，命令行 / Docker 创建的目录默认没有这些属性。
解决思路：用 getfattr 找出图形界面文件夹的属性，再用 setfattr 给自建文件夹补齐同样的 5 个属性。
生效方式：补齐属性后重启系统即可识别；懒人包默认目录同样适用此方法补救。

参考视频

绿联NAS通过命令行创建文件夹无法正常显示～了解文件夹扩展属性即可轻松解决

好用斋官网

好用斋官网｜网盘分享（提取码 492）