FolderShareManager

一个面向 Windows 10/11 的轻量级局域网文件夹共享管理工具。它用图形界面创建和关闭 SMB 共享，并同步处理共享权限、NTFS ACL 与 Windows 防火墙规则。

当前版本为 v0.1.0 公开预览版。程序需要管理员权限。创建共享前请先阅读下面的安全说明。

主要功能

• 选择本地文件夹，检查路径及现有共享状态。
• 创建只读或可读写 SMB 共享。
• 生成 \\电脑名\共享名 和 \\IP\共享名 访问地址。
• 关闭本工具创建的共享，并清理本工具添加的 ACL。
• 默认使用只读权限和 LocalSubnet 防火墙范围。
• Release EXE 内嵌 PowerShell 引擎，可以单文件运行。

下载与运行

从 GitHub Releases 下载 FolderShareManager.exe，并使用同一 Release 中的 SHA256SUMS.txt 校验文件。双击 EXE 后同意 Windows 管理员权限提示。

该项目暂未购买代码签名证书，因此 Windows 可能显示“未知发布者”。请只从项目官方 GitHub Releases 下载，并核对 SHA-256。

安全说明

• 不启用 SMB1、匿名访问或来宾访问。
• 工具使用 Windows 的 Everyone 共享和 NTFS 权限；这不等于开启匿名访问，实际连接仍受 Windows 网络登录策略影响。
• 工具拒绝共享包含自身 EXE 的文件夹，防止网络用户替换管理员程序。
• 工具不会修改或删除不是由 FolderShareManager 创建的共享。
• 日志与 ACL 回滚状态保存在 %LOCALAPPDATA%\FolderShareManager，不会写入 EXE 所在目录。
• Any 是本机 TCP 445 的全局防火墙范围，可能影响本机所有 SMB 共享。除非确实需要跨子网访问，否则请保持默认的 LocalSubnet。
• 不建议共享磁盘根目录、用户主目录、代码仓库、程序目录或包含敏感资料的目录。

更完整的漏洞报告方式见 SECURITY.md。

从源码构建

项目不依赖第三方 NuGet 包，使用 Windows 自带的 .NET Framework C# 编译器。

powershell -NoProfile -ExecutionPolicy Bypass -File .\tests\SourceChecks.ps1
powershell -NoProfile -ExecutionPolicy Bypass -File .\tests\EngineValidationSmoke.ps1
powershell -NoProfile -ExecutionPolicy Bypass -File .\Build.ps1

输出文件为 dist\FolderShareManager.exe。验证内嵌引擎：

$process = Start-Process .\dist\FolderShareManager.exe -ArgumentList --self-test -Wait -PassThru
$process.ExitCode

返回 0 表示单文件资源检查通过。

生成 Release 包

powershell -NoProfile -ExecutionPolicy Bypass -File .\Package-Release.ps1 -Version 0.1.0

生成：

• dist\FolderShareManager.exe
• dist\FolderShareManager-v0.1.0-windows.zip
• dist\SHA256SUMS.txt

推送 v* 标签后，GitHub Actions 会自动构建并创建 GitHub Release。

维护者与贡献

• 主要维护者：zttda
• 共同作者：zuofeng20000218-debug

本项目的部分代码和文档在 OpenAI ChatGPT/Codex 辅助下完成编辑与审查。项目维护者负责审阅并确认最终代码、发布内容与安全性。

许可证

MIT License