---
title: Alpine Linux 通过 fstab 挂载 CIFS 共享
description: 面向企业 IT 运维，说明 Alpine Linux 使用 fstab 挂载 CIFS 共享的适用场景、准备与风险、处理步骤、验证、回退与常见问题，重点覆盖 fstab 字段完整性与网络就绪顺序。
url: "https://www.lanever.com/docs/alpine-linux-%e9%80%9a%e8%bf%87-fstab-%e6%8c%82%e8%bd%bd-cifs-%e5%85%b1%e4%ba%ab/"
updated: "2026-10-12"
category: Linux
---

# Alpine Linux 通过 fstab 挂载 CIFS 共享

> **参考来源与致谢**
>
>
>
> - **引用来源：**[Mounting CIFS (formerly Samba) volumes via fstab on Alpine Linux | Jan Hapke](https://janhapke.com/blog/mount-cifs-samba-fstab-alpine-linux/)
> - **原作者：**原页面署名作者或发布机构（剪藏记录未保存可核验的个人署名）
> - **感谢词：**感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写，并非原文转载；如权利人需要更正署名或来源信息，请联系本站。

## 适用场景

企业内网中，文件服务由 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 错误可能导致启动阶段挂载失败，进而影响依赖本地文件系统的服务。
- 先在测试环境或可回退的快照中验证，再推广到生产主机。

## 处理步骤

1. 安装工具：`apk add cifs-utils`。
2. 创建挂载点：`mkdir -p [挂载点]`。
3. 创建凭据文件并限制权限：`chmod 600 /etc/cifs-credentials`。
4. 编辑 `/etc/fstab`，写入完整六字段条目。Alpine 要求每行包含设备、挂载点、文件系统类型、挂载选项、dump、pass 六项，缺少后两项会报 `can't find ... in /etc/fstab`。
5. 在挂载选项中追加 `_netdev`，使该条目在网络可用后再挂载，避免启动阶段出现 `Network unreachable`。
6. 如系统未自动处理网络挂载，启用 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`。
