所属产品: Mingcedar Share SHARE

Windows / macOS 桌面与 Linux systemd 服务 | Mingcedar Share

安装包、支持平台和版本说明见官网下载中心；共享文件列表只展示主机选定目录。

首次发布 2026-10-25T12:48:42.564963443Z 最近更新 2026-10-25T12:48:42.564962502Z

<div class="manual-doc-article manual-doc-article-section"><h2 id="service-mode">服务: Windows / macOS 桌面与 Linux systemd 服务</h2>

Windows 和 macOS 使用桌面版，可设置当前用户登录时启动应用；Linux 使用 systemd 服务。桌面登录自启不会自动启动共享，Linux 安装脚本则会启用并启动服务。

<h3 id="service-mode-item-1">安装包获取入口</h3>

<p>安装包、支持平台和版本说明见官网下载中心；共享文件列表只展示主机选定目录。</p>

</article>

<h3 id="service-mode-item-2">macOS 安装与运行</h3>

<p>macOS 桌面包要求 macOS 13 或更高版本。打开 DMG，将 Mingcedar Share.app 拖入“应用程序”后启动。按系统提示允许本地网络和所选文件夹访问；菜单栏可恢复窗口，Command-Q 会停止共享并退出。可用架构和安装包获取方式以下载中心为准。</p>

</article>

<h3 id="service-mode-item-3">macOS 登录自启与配置</h3>

<p>“启用登录自启”通过当前用户 LaunchAgent 在登录后打开桌面应用，不会自动启动共享。请先安装到“应用程序”，移动或卸载前关闭自启。新配置位于 <code>~/Library/Application Support/HQ VISU/HQShare/config.json</code>；已有 <code>~/.hqvisu/hqshare/config.json</code> 会继续使用。</p>

</article>

<h3 id="service-mode-item-4">macOS 打开提示</h3>

<p>安装包尚未经过 Apple 公证。若 macOS 阻止打开，请先核对安装包来源，再按系统“隐私与安全性”中的提示处理。</p>

</article>

<h3 id="service-mode-item-5">Linux 配置与环境文件的区别</h3>

<p><code>/etc/hqshare/hqshare.env</code> 指定程序和配置文件路径；实际共享目录、端口、绑定地址和用户信息保存在 <code>config.json</code>。CLI 修改配置后需重启服务。</p>

</article>

<h3 id="service-mode-item-6">Windows 桌面版</h3>

<p>Windows 桌面版设置共享目录、端口和绑定地址，配置默认保存在当前用户目录。</p>

</article>

<h3 id="service-mode-item-7">Windows 系统托盘和登录自启</h3>

<p>关闭窗口后可留在系统托盘运行，也可启用当前 Windows 用户登录自启。使用前核对目录、端口和访问网段。</p>

</article>

<h3 id="service-mode-item-8">Explorer 右键菜单</h3>

<p>Windows 桌面版可为当前用户添加资源管理器右键入口。选择“共享此文件夹”后，应用会使用所选目录和已保存的端口、绑定地址自动启动共享。首次使用前请先在桌面界面配置账号、改密并核对网络范围。</p>

</article>

<h3 id="service-mode-item-9">无界面运行入口</h3>

<p>无桌面环境时，用无界面参数指定目录、端口和绑定地址，交由 systemd、Supervisor 等管理进程。</p>

</article>

<h3 id="service-mode-item-10">Linux 服务配置文件</h3>

<p>Linux systemd 服务默认读取 <code>/etc/hqshare/config.json</code>。共享目录、端口、绑定地址、上传限制和用户账号都保存在这里。</p>

</article>

<h3 id="service-mode-item-11">Linux 开机自启设置</h3>

<p>通过 systemd 启用或关闭 hqshare 开机自启；配置、共享目录和账号不受影响。</p>

<div class="manual-code" data-code-language="text"><div class="manual-code-toolbar"><span>Text</span><span class="manual-code-tools"><small>Text</small><button type="button" data-copy-code data-copied="已复制" data-failed="请选中代码后复制" aria-label="复制代码: Text">复制代码</button><span class="manual-code-status" role="status"></span></span></div><pre tabindex="0" class="docs-code-block shiki github-light" style="background-color:#fff;color:#24292e" tabindex="0"><code><span class="line"><span># Linux：启用开机自启</span></span>

<span class="line"><span>sudo systemctl enable hqshare</span></span>

<span class="line"><span># Linux：关闭开机自启</span></span>

<span class="line"><span>sudo systemctl disable hqshare</span></span>

<span class="line"><span># Linux：查看是否开机自启</span></span>

<span class="line"><span>sudo systemctl is-enabled hqshare</span></span></code></pre></div>

</article>

<h3 id="service-mode-item-12">Linux systemd 服务版</h3>

<p>使用 Linux 服务包里的 systemd 安装脚本部署。安装器使用专用 <code>hqshare</code> 系统用户运行服务。先仅监听本机，通过 CLI 修改初始管理员密码后，再将下面的绑定地址改为实际内网 IP。</p>

<span class="line"><span>cd HQShare-Linux-Service</span></span>

<span class="line"><span>sudo ./install-linux-service.sh --share-path /srv/hqshare/public --port 5995 --bind 127.0.0.1</span></span>

<span class="line"><span>sudo -u hqshare /opt/hqshare/HQShare --config /etc/hqshare/config.json user reset-password admin --password '<设置独立口令>'</span></span>

<span class="line"><span>sudo -u hqshare /opt/hqshare/HQShare --config /etc/hqshare/config.json config set \</span></span>

<span class="line"><span> --share-path /srv/hqshare/public \</span></span>

<span class="line"><span> --max-upload-mb 1024</span></span>

<span class="line"><span>sudo systemctl restart hqshare</span></span></code></pre></div>

</article>

<h3 id="service-mode-item-13">Linux 服务查看和日志</h3>

<p>安装后检查 systemd 状态、运行环境文件和配置文件。配置变更后重启服务，并用日志确认监听端口和共享目录。</p>

<span class="line"><span>sudo journalctl -u hqshare -f</span></span>

<span class="line"><span>sudo cat /etc/hqshare/hqshare.env</span></span>

<span class="line"><span>sudo cat /etc/hqshare/config.json</span></span>

<span class="line"><span>sudo systemctl restart hqshare</span></span>

<span class="line"><span>sudo systemctl stop hqshare</span></span>

<span class="line"><span>sudo systemctl start hqshare</span></span></code></pre></div>

</article>

<h3 id="service-mode-item-14">账户管理和密码修改</h3>

<p>Linux 通过 CLI 管理账号，角色为 <code>viewer</code>、<code>operator</code>、<code>manager</code>。将示例口令替换为独立口令；新增、禁用、删除账号或修改密码、角色后，须重启服务加载配置并清除旧会话。</p>

<span class="line"><span>sudo -u hqshare /opt/hqshare/HQShare --config /etc/hqshare/config.json user add operator01 --password '<设置独立口令>' --role operator --display-name '现场操作员'</span></span>

<span class="line"><span>sudo -u hqshare /opt/hqshare/HQShare --config /etc/hqshare/config.json user update operator01 --role viewer</span></span>

<span class="line"><span>sudo -u hqshare /opt/hqshare/HQShare --config /etc/hqshare/config.json user reset-password operator01 --password '<设置新口令>'</span></span>

<span class="line"><span>sudo -u hqshare /opt/hqshare/HQShare --config /etc/hqshare/config.json user update operator01 --disable</span></span>

<span class="line"><span>sudo -u hqshare /opt/hqshare/HQShare --config /etc/hqshare/config.json user update operator01 --enable</span></span>

<span class="line"><span>sudo -u hqshare /opt/hqshare/HQShare --config /etc/hqshare/config.json user delete operator01</span></span>

<span class="line"><span>sudo systemctl restart hqshare</span></span></code></pre></div>

</article>

<h3 id="service-mode-item-15">端口占用处理</h3>

<p>端口占用时，桌面版提示建议端口；服务版需修改端口配置并重启。</p>

</article>

<h3 id="service-mode-item-16">绑定地址建议</h3>

<p><code>0.0.0.0</code> 监听所有 IPv4 接口，指定 IP 只监听该地址，<code>127.0.0.1</code> 仅供本机访问。界面地址仅为候选，并非全部可用；用实际绑定的 IP、端口验证，通过防火墙限制来源。</p>

</article>

</div>

<strong>图示 1: macOS 桌面运行</strong>

<p>macOS 桌面界面：配置共享目录和访问地址，并查看服务运行状态。</p>

</figcaption>

</figure>

</div>