参考来源与致谢
- 引用来源:Mounting CIFS (formerly Samba) volumes via fstab on Alpine Linux | Jan Hapke
- 原作者:原页面署名作者或发布机构(剪藏记录未保存可核验的个人署名)
- 感谢词:感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写,并非原文转载;如权利人需要更正署名或来源信息,请联系本站。
适用场景 #
企业内网中,文件服务由 Windows 或兼容 CIFS/SMB 的存储提供,Linux 主机需要把共享目录挂载到本地固定路径,供应用或运维脚本长期访问。Alpine Linux 使用 BusyBox 工具链,fstab 解析比部分发行版更严格,且启动顺序与网络依赖需要显式声明。本文适用于通过 /etc/fstab 持久挂载 CIFS 共享的运维场景。
准备与风险 #
- 确认已安装
cifs-utils,否则mount.cifs不可用。 - 准备可用的共享地址、共享名、挂载点、账号与凭据文件路径,参数一律使用占位符,例如
[服务器地址]、[共享名]、[挂载点]、[管理员账号]。 - 凭据不要直接写入 fstab。建议使用权限受限的凭据文件,例如
/etc/cifs-credentials,并设置chmod 600。 - 修改 fstab 前先备份:
cp /etc/fstab /etc/fstab.bak。fstab 错误可能导致启动阶段挂载失败,进而影响依赖本地文件系统的服务。 - 先在测试环境或可回退的快照中验证,再推广到生产主机。
处理步骤 #
- 安装工具:
apk add cifs-utils。 - 创建挂载点:
mkdir -p [挂载点]。 - 创建凭据文件并限制权限:
chmod 600 /etc/cifs-credentials。 - 编辑
/etc/fstab,写入完整六字段条目。Alpine 要求每行包含设备、挂载点、文件系统类型、挂载选项、dump、pass 六项,缺少后两项会报can't find ... in /etc/fstab。 - 在挂载选项中追加
_netdev,使该条目在网络可用后再挂载,避免启动阶段出现Network unreachable。 - 如系统未自动处理网络挂载,启用 netmount 服务:
rc-update add netmount default。
# /etc/fstab 示例结构,参数均为占位符
//[服务器地址]/[共享名] [挂载点] cifs credentials=/etc/cifs-credentials,_netdev,uid=[本地用户],gid=[本地组] 0 0
破坏性操作提醒:修改 fstab 或重启前,务必确认已备份原文件,并保留可用的本地登录方式,避免因挂载失败导致系统服务异常。
验证方法 #
- 手动挂载:
mount [挂载点],观察是否返回错误。 - 查看挂载结果:
mount | grep [挂载点]。 - 读写测试:在挂载点创建并删除测试文件,确认权限与网络连通性。
- 重启验证:重启后检查
dmesg与系统日志中是否仍有挂载失败信息。 - 服务状态:
rc-service netmount status。
回退建议 #
- 恢复备份:
cp /etc/fstab.bak /etc/fstab。 - 卸载异常挂载:
umount [挂载点];若占用,先停止相关进程再卸载。 - 若启动受影响,进入单用户或救援模式修复 fstab,再重启。
- 移除 netmount 自启:
rc-update del netmount default。
常见问题 #
- 命令行可挂载但 fstab 报找不到条目:检查是否为完整六字段。
- 启动时报
Network unreachable:确认挂载选项含_netdev,并确认 netmount 已启用。 - 重启后共享未挂载:检查凭据文件权限、共享地址可达性及服务启动顺序。
- 不同 Alpine 版本对 fstab 与启动脚本行为可能存在差异,具体以对应版本文档与手册页为准,例如
man mount.cifs、man fstab。
