将 NAS 通过 Reverse SSH 和 Docker 绑定为自有存储(以 QNAP 为例)

本主题内容

使用 Reverse SSH 时,您的 NAS 会自行建立一条到 PaperOffice 的出站加密连接(隧道)。无需在路由器中进行端口转发。PaperOffice AI 随后会将某个 Workspaces 的加密文档存储在您的 NAS 上。

请在创建 Workspace 之前先创建存储。Workspaces 的存储模式在创建后不可更改。

步骤 1:准备 NAS(以 QNAP 为例)

QTS 中的菜单可能因 QTS 版本不同而略有差异。

  1. 请创建一个专用的共享文件夹,例如 paperoffice,而不是 PaperOffice Classic 或 MariaDB 的文件夹。
  2. 请在“控制台 › 网络和文件服务 › Telnet / SSH”下允许 SSH 和 SFTP。
  3. 请在该处的“编辑访问权限”中添加您用于登录的 NAS 用户。如果该用户不在此列表中,NAS 将拒绝 SSH 登录。
  4. 请安装 Container Station(Docker)。您可以保留建议的容器共享文件夹。

Synology:Container Manager,启用用户主目录服务,用户属于 administrators 组。ASUSTOR:Docker Engine。UGREEN:Docker。

步骤 2:在 PaperOffice AI 中创建存储

  1. 请打开 Document AI › Storage Mounts 并点击 添加 Storage Mount。
  2. 带有红色星号(*)的字段为必填字段。
  3. 此 Storage Mount 的名称:可自由填写。
  4. 付款附言:用作 BYOS-Storage。
  5. 连接类型:通过反向SSH连接本地文件夹。
  6. 您的 NAS:请选择 QNAP。随后应用会建议 /share/paperoffice(Synology、ASUSTOR、UGREEN:/volume1/paperoffice)。
  7. 本地 SSH 用户:您在 NAS 上的用户。该用户必须是管理员组成员。
  8. 本地文件夹:文件夹的完整路径,在 QNAP 上为 /share/<Name des Freigabeordners>。不要使用引号、反斜杠和 * ? [ ]。文件夹和用户之后无法再更改。
  9. 加密密码 和 确认密码:至少 16 个字符,或使用 生成安全密码(钥匙图标)。
  10. 请点击 下载为 .txt。只有在此之后才能创建存储。请妥善保存该文件:没有密码将无法恢复。
  11. 请勾选确认复选框并保存。

步骤 3:选择正确的设置模块

保存后,窗口 反向SSH设置 将打开并显示您的 隧道别名。在顶部,请选择以下变体:

  • 带有 Docker 的 NAS:一个启动小型隧道容器的块。对于使用 Container Station 的 QNAP 设备,这是正确的选择。
  • NAS 无需 Docker:通过 SSH 执行一次 Block 1,将 Block 2 添加到自动启动项。
  • Linux / macOS 和 Windows:适用于计算机。

复制包含 复制设置 的块。在 NAS 无需 Docker 中,这两个块各自拥有独立的按钮。

步骤 4:登录至 NAS 并粘贴该块

例如,在 Windows 上使用 PuTTY(具体名称可能因版本而异):

  1. 在“主机”字段中输入您 NAS 的家庭网络 IP 地址,端口为 22,然后建立连接。
  2. 使用步骤 2 中的 NAS 用户进行登录。输入密码时屏幕上不会显示任何字符,这是正常现象。
  3. QNAP 在登录后可能会显示控制台菜单(例如“Console Management”),请按 QTS 版本的不同,依次按 Q 和 Y 退出该菜单以进入常规命令行界面。
  4. 在窗口中右键单击即可粘贴该块。随后请按回车键。

在 Mac 上:打开“终端”程序,然后输入 ssh <Benutzer>@<IP-Adresse des NAS>。

该块仅应粘贴至 NAS 的此窗口中。NAS 需要互联网连接:隧道由您的 NAS 向外建立,且容器在启动时会加载一个小型 Linux 软件包。

步骤 5:测试连接

  1. 通过 编辑 在 Storage Mounts 中打开存储。
  2. 点击 测试连接(此操作仅在保存后可用)。
  3. 成功提示:“隧道已激活:NAS 可达且文件夹可写。”随后,使用 自有存储 (BYOS) 创建您的 Workspace。

如果测试显示登录被拒绝,请检查步骤 1 中的 NAS 用户及访问列表。然后,以注册的 NAS 用户身份重新添加该配置并再次进行测试。

Trace(跟踪)显示的内容

在概览中,测试连接 启动带有地图的 PaperOffice 跟踪。对于 Reverse SSH,隧道的目标服务器是 PaperOffice 的服务器,而非您的 NAS。位置信息仅为该路径上的网络节点,并非您文件的存储位置。

重启后

只要 Docker 正在运行,隧道容器在每次重启后都会自动启动。如果连接中断,它将在 10 秒后重新连接。如果没有 Docker,则通过自动启动中的第 2 个块来确保连接。

安全性:设置块包含私钥

该块包含一个私钥,并将其作为您 NAS 用户的登录密钥。拥有该块的人可以冒充您的隧道,并在 SSH 服务对其可访问的情况下,以您的 NAS 用户身份登录。您的加密密码并未包含在该块中。

  • 切勿将块放入聊天、AI 助手、电子邮件或支持工单中。
  • Support(客户支持)不需要该块。请改为提供测试的错误消息。

Wenn es doch passiert ist:

  1. 尽可能删除该消息。
  2. 没有“重新生成密钥”按钮。编辑时密钥保持不变。
  3. 如果尚未有 Workspace 使用该存储:请删除 Storage Mount。PaperOffice 会从隧道服务器移除密钥;NAS 上的文件保留。重新创建存储(新密钥、新隧道别名),使用相同的加密密码或空文件夹。
  4. 在 NAS 上移除旧密钥:在您的 NAS 用户的 .ssh 文件夹中,删除 authorized_keys 中以“PaperOffice”和旧隧道别名结尾的行,以及文件 paperoffice_<alter Tunnel-Alias>。如果使用 Docker:请在您的 Docker 界面(QNAP:Container Station)中删除名称以 paperoffice-tunnel- 开头的旧容器。如果不使用 Docker:请在同一文件夹 .ssh 中删除脚本 paperoffice_tunnel_<alter Tunnel-Alias>.sh,并从自动启动中移除旧条目。
  5. 如果已有 Workspace 使用该存储,则无法删除它。此时请在 App 中的 支持 创建工单,并说明密钥已泄露。切勿在此过程中包含该块。

后续步骤