ksmbd-tools 的安装和配置教程

1. 项目基础介绍和主要编程语言

ksmbd-tools 是一组用户空间工具，用于配合 ksmbd 内核服务器工作。ksmbd 是一个高性能的 SMB/CIFS 服务器，它直接在内核空间处理 SMB 协议，提高了文件服务性能。ksmbd-tools 主要使用 C 语言编写，提供了管理共享、用户、配置等功能。

2. 项目使用的关键技术和框架

ksmbd-tools 使用的关键技术包括：

• 内核模块与用户空间工具的交互：ksmbd-tools 通过信号等方式与内核模块通信，实现动态配置更新等功能。
• SMB/CIFS 协议：ksmbd-tools 遵循 SMB/CIFS 协议，为用户提供文件共享服务。
• 配置文件管理：ksmbd-tools 使用配置文件来管理共享设置，用户可以通过工具来修改这些配置。

项目中并没有使用特定的框架，而是基于标准的 C 语言库和系统调用来构建。

3. 项目安装和配置的准备工作和详细安装步骤

准备工作

在开始安装 ksmbd-tools 之前，请确保您的系统已安装以下依赖：

• git
• gcc
• pkgconf
• autoconf
• automake
• libtool
• make
• meson
• ninja-build
• gawk
• libnl-3-dev 或 libnl3-devel（取决于您的发行版）
• glib2.0-dev 或 glib2-devel

安装步骤

1. 克隆项目仓库：

   git clone https://github.com/cifsd-team/ksmbd-tools.git
   cd ksmbd-tools
   

2. 使用 autotools 构建：

   ./autogen.sh
   ./configure --with-rundir=/run
   make
   sudo make install
   

   或者，如果您更喜欢 meson：

   mkdir build
   cd build
   meson -Drundir=/run ..
   ninja
   sudo ninja install
   

   请注意，默认情况下，工具会被安装在 /usr/local/sbin，而它们使用的文件默认位于 /usr/local/etc/ksmbd 目录下。

3. 添加共享：

   mkdir -vp ~/MyShare
   sudo ksmbd.addshare --add --option "path = ~/MyShare" --option 'read only = no' MyShare
   

4. 添加用户：

   sudo ksmbd.adduser --add MyUser
   

   系统会提示您输入密码。

5. 更新共享参数，强制所有用户映射到当前用户：

   sudo ksmbd.addshare --update --option "force user = $USER" --option "force group = $USER" MyShare
   

6. 加载内核模块：

   sudo modprobe ksmbd
   

7. 启动用户和内核模式守护进程：

   sudo ksmbd.mountd
   

8. 挂载新的共享：

   sudo mount -o user=MyUser //127.0.0.1/MyShare /mnt
   

   系统会提示您输入之前设置的密码。

9. 更新用户密码（可选）：

   sudo ksmbd.adduser --update --password MyNewPassword MyUser
   

10. 删除用户（可选）：

    sudo ksmbd.adduser --delete MyUser
    

11. 如果在不使用工具的情况下进行了更改，可以通过发送 SIGHUP 信号来通知 ksmbd.mountd：

    sudo ksmbd.control --reload
    

12. 重启守护进程以应用全局参数的更改（如果有必要）：

    sudo ksmbd.control --shutdown
    sudo ksmbd.mountd
    

13. 移除内核模块（可选）：

    sudo modprobe -r ksmbd
    

以上步骤为您提供了 ksmbd-tools 的基础安装和配置指南。请根据实际需求调整步骤中的参数和路径。