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

# autotools build

./autogen.sh
./configure --with-rundir=/run

make
sudo make install

# meson build

mkdir build
cd build
meson -Drundir=/run ..

ninja
sudo ninja install

man 8 ksmbd.addshare
man 8 ksmbd.adduser
man 8 ksmbd.control
man 8 ksmbd.mountd
man 5 ksmbd.conf
man 5 ksmbdpwd.db

# 如果你使用 autoconf 默认设置自行构建并安装了 ksmbd-tools，工具位于 /usr/local/sbin'，默认用户数据库是 /usr/local/etc/ksmbd/ksmbdpwd.db'，默认配置文件是 `/usr/local/etc/ksmbd/ksmbd.conf'。

# 否则，工具可能位于 /usr/sbin'，默认用户数据库是 /etc/ksmbd/ksmbdpwd.db'，默认配置文件是 `/etc/ksmbd/ksmbd.conf'。

# 创建共享路径目录。共享使用其底层文件系统在此目录中存储文件。
mkdir -vp $HOME/MyShare

# 将共享添加到默认配置文件。请注意，ksmbd.addshare 不进行变量扩展。没有 --add 时，如果 MyShare 存在，ksmbd.addshare 将更新 MyShare。
sudo ksmbd.addshare --add \
                    --option "path = $HOME/MyShare" \
                    --option 'read only = no' \
                    MyShare

# 默认配置文件现在有一个新的部分用于 MyShare。
#
# [MyShare]
#         ; share parameters
#         path = /home/tester/MyShare
#         read only = no
#

# 每个共享都有自己的部分，其中包含适用于该共享的共享参数。在 [global] 中给出的共享参数会更改其默认值。[global] 还包含一些不特定于共享的全局参数。

# 你可以通过省略 --option 来交互式地更新共享。如果没有 --update，ksmbd.addshare 会添加 MyShare（如果它不存在的话）。
sudo ksmbd.addshare --update MyShare

# 将用户添加到默认用户数据库。系统将提示你输入密码。
sudo ksmbd.adduser --add MyUser

# 没有名为 MyUser 的系统用户，因此需要将其映射到一个系统用户。我们可以强制所有访问共享的用户映射到一个系统用户和组。

更# 新默认配置文件中共享的共享参数。
sudo ksmbd.addshare --update \
                    --option "force user = $USER" \
                    --option "force group = $USER" \
                    MyShare

# 默认配置文件现在包含更新后的共享参数。
#
# [MyShare]
#         ; share parameters
#         force group = tester
#         force user = tester
#         path = /home/tester/MyShare
#         read only = no
#

# 加载内核模块。
sudo modprobe ksmbd

# 启动用户模式和内核模式守护程序。所有接口默认都被监听。
sudo ksmbd.mountd

# 使用 cifs-utils 挂载新共享，并以新用户身份进行身份验证。你将被提示输入之前使用 ksmbd.adduser 设置的密码。
sudo mount -o user=MyUser //127.0.0.1/MyShare /mnt

# 你现在可以在 /mnt 访问该共享。
sudo touch /mnt/new_file_from_cifs_utils

# 卸载该共享。
sudo umount /mnt

# 更新默认用户数据库中用户的密码。
# 可以使用 --password 选项来指定密码，而不是提示输入密码。
sudo ksmbd.adduser --update --password MyNewPassword MyUser

# 从默认用户数据库中删除一个用户。
sudo ksmbd.adduser --delete MyUser

# 这些工具通过向 ksmbd.mountd 发送 SIGHUP 信号来通知其更改。在不使用这些工具的情况下进行更改时，可以手动执行此操作。
sudo ksmbd.control --reload

# 切换 ksmbd 对 "smb" 组件的调试打印。
sudo ksmbd.control --debug smb

# 有些更改需要重新启动用户模式和内核模式守护程序。修改任何全局参数就是这种更改的一个例子。重新启动意味着在关闭守护程序后启动 ksmbd.mountd。

# Shutdown the user and kernel mode daemons.
sudo ksmbd.control --shutdown

# 卸载内核模块。
sudo modprobe -r ksmbd