本主题内容
使用 Reverse SSH 时,您的 NAS 会自行建立一条到 PaperOffice 的出站加密连接(隧道)。无需在路由器中进行端口转发。PaperOffice AI 随后会将某个 Workspaces 的加密文档存储在您的 NAS 上。
请在创建 Workspace 之前先创建存储。Workspaces 的存储模式在创建后不可更改。
步骤 1:准备 NAS(以 QNAP 为例)
QTS 中的菜单可能因 QTS 版本不同而略有差异。
- 请创建一个专用的共享文件夹,例如
paperoffice,而不是 PaperOffice Classic 或 MariaDB 的文件夹。 - 请在“控制台 › 网络和文件服务 › Telnet / SSH”下允许 SSH 和 SFTP。
- 请在该处的“编辑访问权限”中添加您用于登录的 NAS 用户。如果该用户不在此列表中,NAS 将拒绝 SSH 登录。
- 请安装 Container Station(Docker)。您可以保留建议的容器共享文件夹。
Synology:Container Manager,启用用户主目录服务,用户属于 administrators 组。ASUSTOR:Docker Engine。UGREEN:Docker。
步骤 2:在 PaperOffice AI 中创建存储
- 请打开 Document AI › Storage Mounts 并点击 添加 Storage Mount。
- 带有红色星号(*)的字段为必填字段。
- 此 Storage Mount 的名称:可自由填写。
- 付款附言:用作 BYOS-Storage。
- 连接类型:通过反向SSH连接本地文件夹。
- 您的 NAS:请选择 QNAP。随后应用会建议
/share/paperoffice(Synology、ASUSTOR、UGREEN:/volume1/paperoffice)。 - 本地 SSH 用户:您在 NAS 上的用户。该用户必须是管理员组成员。
- 本地文件夹:文件夹的完整路径,在 QNAP 上为
/share/<Name des Freigabeordners>。不要使用引号、反斜杠和* ? [ ]。文件夹和用户之后无法再更改。 - 加密密码 和 确认密码:至少 16 个字符,或使用 生成安全密码(钥匙图标)。
- 请点击 下载为 .txt。只有在此之后才能创建存储。请妥善保存该文件:没有密码将无法恢复。
- 请勾选确认复选框并保存。
步骤 3:选择正确的设置模块
保存后,窗口 反向SSH设置 将打开并显示您的 隧道别名。在顶部,请选择以下变体:
- 带有 Docker 的 NAS:一个启动小型隧道容器的块。对于使用 Container Station 的 QNAP 设备,这是正确的选择。
- NAS 无需 Docker:通过 SSH 执行一次 Block 1,将 Block 2 添加到自动启动项。
- Linux / macOS 和 Windows:适用于计算机。
复制包含 复制设置 的块。在 NAS 无需 Docker 中,这两个块各自拥有独立的按钮。
步骤 4:登录至 NAS 并粘贴该块
例如,在 Windows 上使用 PuTTY(具体名称可能因版本而异):
- 在“主机”字段中输入您 NAS 的家庭网络 IP 地址,端口为
22,然后建立连接。 - 使用步骤 2 中的 NAS 用户进行登录。输入密码时屏幕上不会显示任何字符,这是正常现象。
- QNAP 在登录后可能会显示控制台菜单(例如“Console Management”),请按 QTS 版本的不同,依次按
Q和Y退出该菜单以进入常规命令行界面。 - 在窗口中右键单击即可粘贴该块。随后请按回车键。
在 Mac 上:打开“终端”程序,然后输入 ssh <Benutzer>@<IP-Adresse des NAS>。
该块仅应粘贴至 NAS 的此窗口中。NAS 需要互联网连接:隧道由您的 NAS 向外建立,且容器在启动时会加载一个小型 Linux 软件包。
步骤 5:测试连接
- 通过 编辑 在 Storage Mounts 中打开存储。
- 点击 测试连接(此操作仅在保存后可用)。
- 成功提示:“隧道已激活: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:
- 尽可能删除该消息。
- 没有“重新生成密钥”按钮。编辑时密钥保持不变。
- 如果尚未有 Workspace 使用该存储:请删除 Storage Mount。PaperOffice 会从隧道服务器移除密钥;NAS 上的文件保留。重新创建存储(新密钥、新隧道别名),使用相同的加密密码或空文件夹。
- 在 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,并从自动启动中移除旧条目。 - 如果已有 Workspace 使用该存储,则无法删除它。此时请在 App 中的 支持 创建工单,并说明密钥已泄露。切勿在此过程中包含该块。