简介这份资源面向需要在 Windows 与 Linux/Unix 之间搭建文件与打印共享环境的运维人员和嵌入式开发者核心是 Samba 3.0 的安装包与配套工具同时包含 SAM-BA 微控制器烧录辅助程序可用于固件更新与硬件调试。压缩包共 89 个文件约 23.62MB以 html 文档、dll 动态库、qml 界面描述文件为主另有 txt 说明、bin 固件、js 脚本、exe 主程序及 conf 配置示例覆盖程序运行、界面渲染与文档查阅等用途。目前已有 734 人学习下载。通过包内文档与配置示例读者可理解 smb.conf 的共享权限、用户访问控制与 NTLMv2 身份验证等设置掌握将 Linux 服务器接入 Windows 网络、提供文件与打印机共享的方法并借助 SAM-BA 工具完成设备连接与固件烧录适合作为跨平台共享与嵌入式调试的参考材料。1. Samba 3.0老版本为什么还在生产环境里跑一台跑了十几年的老业务系统前端是 Windows 客户端后端是某台 Linux 服务器中间靠 SMB 协议共享目录读写文件。运维想升级发现新版本 Samba 在这套环境里认证过不去回退到 Samba 3.0 反而一切正常。这不是段子是我这两年帮人排查共享目录问题时反复遇到的场景。Samba 3.0 发布于 2003 年前后它实现了 SMB/CIFS 协议让 Linux/Unix 主机能以文件服务器身份出现在 Windows 网络邻居里核心能力是共享目录、用户认证、打印服务和域控模拟。今天还在用它的人多半是被老客户端、老应用或老认证方式绑住了。这篇笔记不讲历史只讲怎么把它跑起来、参数怎么设、坑在哪以及什么情况下该换、什么情况下继续用。2. 把 Samba 3.0 跑起来从编译到最小共享2.1 为什么有人还在用 3.0 而不是 4.x先说选型理由不然读者会觉得这是开倒车。Samba 4.x 默认走 SMB2/SMB3认证模型和 AD 域集成更现代但代价是对老客户端兼容性收紧。一些基于 SMB1 的老应用、老扫描仪、老工控软件在 4.x 上要么连不上要么需要额外打开server min protocol NT1这类降级开关而 3.0 天生就是 SMB1 时代的产物协议栈简单行为可预测。另一个现实原因是依赖。Samba 3.0 的编译依赖少./configure一把过不需要 Python、不需要 GnuTLS 新版本、不需要 LDAP 库。在一些内核和 glibc 都很老的发行版上4.x 根本编不过3.0 反而能跑。我一般会先问一句客户端能不能改能改就上 4.x不能改再考虑 3.0。这个判断顺序很重要别一上来就装老版本。2.2 源码编译的最小命令序列假设你拿到的是samba-3.0.x.tar.gz放在/usr/local/src下。下面是我常用的编译流程每一步都带注释。# 解压源码包进入目录 tar -zxvf samba-3.0.37.tar.gz -C /usr/local/src cd /usr/local/src/samba-3.0.37/source # 配置指定安装前缀关闭不需要的组件减少依赖 ./configure \ --prefix/usr/local/samba \ --with-configdir/usr/local/samba/lib \ --with-lockdir/usr/local/samba/var/locks \ --with-logfilebase/usr/local/samba/var \ --without-ldap \ --without-ads \ --without-krb5 # 编译并安装老机器上 make -j2 就够别开太高 make make install--prefix决定安装根目录我习惯放/usr/local/samba和系统包管理器隔离避免和发行版自带的 Samba 冲突。--without-ldap、--without-ads、--without-krb5是关掉域控相关功能如果你只是做独立文件服务器这些用不上关掉能少一堆编译错误。--with-lockdir和--with-logfilebase分开指定是为了后面排查锁文件和日志方便。编译完检查一下二进制/usr/local/samba/sbin/smbd -V # 输出类似 Version 3.0.37如果这里报动态库找不到说明--prefix下的 lib 没进LD_LIBRARY_PATH在/etc/ld.so.conf.d/下加一行路径再ldconfig即可。2.3 smb.conf 最小可用配置与参数含义配置文件默认在/usr/local/samba/lib/smb.conf。下面这份是我给独立文件服务器用的最小配置能跑通再往上加。[global] workgroup WORKGROUP server string File Server security user map to guest Bad User log level 1 log file /usr/local/samba/var/log.%m max log size 50 load printers no printing bsd printcap name /dev/null disable spoolss yes [share] comment Shared Directory path /data/share browseable yes writable yes valid users smbuser create mask 0644 directory mask 0755security user是 3.0 里最常用的认证模式客户端用服务器本地系统账号登录。map to guest Bad User让不存在的用户自动降级为 guest避免匿名访问直接报错。log file ...%m里的%m是客户端 NetBIOS 名多客户端时日志会按机器名分开排查谁连不上特别有用。load printers no和disable spoolss yes是关打印不做打印服务器就别开开了反而多一堆报错。[share]段里valid users限定只有smbuser能访问create mask和directory mask控制新建文件的权限。注意这两个 mask 是“掩码”不是“权限”0644表示新建文件权限是rw-r--r--别写成777否则共享目录里全是可执行文件后面权限审计会很难看。2.4 添加用户并验证共享Samba 3.0 的用户体系依赖系统账号先建系统用户再用smbpasswd设 Samba 密码。# 建系统用户不建家目录shell 设为 nologin useradd -M -s /sbin/nologin smbuser # 设置 Samba 密码会提示输入两次 /usr/local/samba/bin/smbpasswd -a smbuser # 启动服务 /usr/local/samba/sbin/smbd -D /usr/local/samba/sbin/nmbd -Dsmbd负责文件和认证nmbd负责 NetBIOS 名称解析两个都要起。-D是后台运行。验证时先在服务器本机用smbclient看列表/usr/local/samba/bin/smbclient -L localhost -U smbuser能列出share就说明服务端通了。再从 Windows 客户端\\服务器IP\share访问输入smbuser和刚才设的密码。如果连不上先看/usr/local/samba/var/log.smbd和按客户端名生成的日志文件里面会写清楚是认证失败还是路径权限问题。3. 认证与权限Samba 3.0 最容易翻车的地方3.1 security 三种模式怎么选Samba 3.0 的security参数有三个常用值share、user、server。share是早期无认证模式现在基本没人用除非是纯匿名只读共享。user是默认推荐客户端用服务器本地账号认证。server是把认证转发到另一台 SMB 服务器配置复杂且依赖网络除非有明确的级联认证需求否则别碰。我一般只推荐user。选它的理由是认证链路短账号和权限都在本机出问题好排查。如果客户端要求匿名访问用map to guest Bad User配合guest ok yes实现而不是把security改成share。share模式下权限控制很弱容易出安全事件。3.2 用户映射与 smbpasswd 的坑Samba 3.0 的用户密码存在smbpasswd文件里默认路径是/usr/local/samba/private/smbpasswd。这个文件和系统/etc/shadow是两套东西改系统密码不会同步 Samba 密码反之亦然。常见翻车是系统账号建了smbpasswd -a也执行了但客户端还是认证失败。原因通常是smbpasswd文件权限不对或者smbd启动时读的不是同一个文件。检查命令ls -l /usr/local/samba/private/smbpasswd # 应该是 -rw------- root root 或对应运行用户如果权限是644smbd会拒绝读取日志里会有smbpasswd file not found or permission denied。改成600再重启smbd。另外smbpasswd -a添加的用户必须先在系统里存在否则会报Failed to add entry for user。顺序不能反。3.3 目录权限与 create mask 的配合共享目录的最终权限是“系统目录权限”和“Samba mask”共同作用的结果。很多人只改smb.conf里的create mask忘了path指向的目录本身权限。比如/data/share属主是root:root且权限755smbuser即使有writable yes也写不进去因为系统层面就没写权限。正确做法是先把目录属主改成 Samba 用户或用户组chown -R smbuser:smbuser /data/share chmod -R 755 /data/share然后smb.conf里create mask 0644、directory mask 0755。这样新建文件属主是smbuser权限644新建目录755。如果多个用户共享一个目录建议建一个用户组目录属组设为该组chmod 2775加 SGID 位保证新建文件继承组避免组权限丢失。3.4 用 testparm 做配置自检改完smb.conf别急着重启先跑testparm/usr/local/samba/bin/testparm -v /usr/local/samba/lib/smb.conf它会逐行解析配置报出语法错误和未知参数。Samba 3.0 对参数名大小写不敏感但拼写错误不会报错只会静默忽略导致你以为设了其实没生效。testparm能把这些“隐形参数”揪出来。我习惯每次改配置都跑一遍确认没有Unknown parameter再重启。4. 避坑与排查Samba 3.0 的五个血泪现场4.1 客户端能连上但看不到共享目录现象Windows 输入\\IP能弹出认证框认证通过后目录列表是空的。原因browseable no或者nmbd没启动。Samba 3.0 的目录浏览依赖nmbd做名称广播只起smbd时直接输入\\IP\share能访问但网络邻居里看不到。解决确认nmbd -D已启动smb.conf里对应共享段browseable yes。如果还是不行检查防火墙是否放行 UDP 137、138 和 TCP 139、445。4.2 写入文件后权限变成 000 或 600现象客户端新建文件服务器上看权限是000或600其他用户读不了。原因create mask设成了0600或更小或者系统umask干扰。Samba 3.0 新建文件权限 create mask与系统 umask 的按位与结果。解决把create mask设为0644directory mask设为0755并确认启动smbd的用户 umask 是022。可以在启动脚本里显式umask 022。4.3 大文件传输中途断开现象拷贝超过 2GB 的文件时连接中断日志报read error或write error。原因Samba 3.0 默认max xmit和 socket 缓冲区偏小老内核上大文件传输容易超时。解决在[global]加max xmit 65535、socket options TCP_NODELAY SO_RCVBUF65536 SO_SNDBUF65536然后重启。如果还断检查客户端和服务端之间的网络设备是否有会话超时设置。4.4 中文文件名显示乱码现象Windows 客户端看到的中文文件名是乱码或者上传后服务器上文件名变成问号。原因字符集不匹配。Samba 3.0 默认unix charset和display charset可能不是 UTF-8。解决在[global]加unix charset UTF-8、display charset UTF-8、dos charset CP936。dos charset是给老 Windows 客户端用的现代客户端一般走 UTF-8但设上兼容性更好。改完重启smbd已有乱码文件名需要手动重命名。4.5 服务启动后自动退出现象smbd -D执行后进程几秒就没了ps查不到。原因配置文件路径不对或者smbd找不到smbpasswd文件或者端口被占用。解决先不带-D前台运行smbd -i看报错输出。常见是bind failed on port 445说明已有其他 SMB 服务在跑用netstat -tlnp | grep 445找到并停掉。如果是配置文件路径问题用-s显式指定smbd -D -s /usr/local/samba/lib/smb.conf。5. 进阶用 smbclient 做自动化验证与迁移判断5.1 用 smbclient 写一个共享可用性检查脚本生产环境里共享目录是否可读写不能靠人肉点我一般写个脚本定时跑。smbclient支持非交互式命令适合做这个。#!/bin/bash # 检查 Samba 共享是否可读写 SERVER127.0.0.1 SHAREshare USERsmbuser PASSyourpassword TESTFILEhealthcheck_$(date %s).txt # 尝试写入一个测试文件 /usr/local/samba/bin/smbclient //$SERVER/$SHARE -U $USER%$PASS \ -c put /etc/hostname $TESTFILE /dev/null 21 if [ $? -ne 0 ]; then echo WRITE FAILED exit 1 fi # 尝试读取并删除 /usr/local/samba/bin/smbclient //$SERVER/$SHARE -U $USER%$PASS \ -c get $TESTFILE /tmp/$TESTFILE; rm $TESTFILE /dev/null 21 if [ $? -ne 0 ]; then echo READ FAILED exit 1 fi echo OK脚本里-U $USER%$PASS是用户名密码的简写-c后面跟分号分隔的命令序列。put上传、get下载、rm删除三步都成功才算共享健康。这个脚本可以挂到监控系统里比 ping 端口更能反映真实可用性。注意密码别硬编码在脚本里生产环境用凭据文件或环境变量。5.2 什么情况下该从 3.0 迁到 4.x不是所有 Samba 3.0 都值得留。如果满足下面任意一条我建议规划迁移客户端全是 Windows 10 及以上且能改配置有安全合规要求必须支持 SMB2/SMB3 加密需要 AD 域集成或 LDAP 认证共享目录超过 1TB 且并发客户端超过 50。迁移时先在测试环境用 4.x 的server min protocol NT1兼容模式跑一遍确认老客户端能连再逐步切。如果客户端是嵌入式设备、老工控机改不了协议那就继续用 3.0但要做好网络隔离只允许特定 IP 访问 445 端口别暴露在办公网里。我自己的习惯是老版本可以留但必须圈在一个 VLAN 里进出都做访问控制这是底线。5.3 一个具体技巧用 log level 精准定位认证问题Samba 3.0 的日志级别从 0 到 10默认log level 1只记启动和错误。排查认证问题时临时调到 3 或 5能看到认证过程的每一步。[global] log level 3 log file /usr/local/samba/var/log.%m调完后重启smbd客户端再连一次然后看对应客户端名的日志文件。里面会写auth_check_password的结果、用户映射过程、以及具体拒绝原因。定位完记得调回 1否则日志涨得很快磁盘容易被撑满。这个技巧我用了很多次比盲猜参数快得多。最后说个教训我早年图省事把security share和guest ok yes一起用在一个对外共享上结果被扫描到目录里多了一堆不该有的文件。从那以后任何共享我都先问“谁能访问”再配valid users和hosts allow宁可多写两行也不留匿名口子。希望帮到你。本文还有配套的精品资源点击获取