在SSHwifty中通过Tailscale实现跨网络SSH连接的技术方案

背景介绍

SSHwifty是一个基于Web的SSH客户端，可以方便地通过浏览器访问SSH服务器。在实际部署中，用户经常需要在不同网络环境间建立SSH连接。本文将详细介绍如何通过Tailscale专用网络实现SSHwifty容器与跨网络设备的SSH连接。

问题分析

当SSHwifty部署在Synology NAS的Docker容器中，且NAS连接了Tailscale专用网络时，可能会遇到以下情况：

1. 通过反向代理可以从外部网络访问SSHwifty
2. 但无法通过SSHwifty连接到同样处于Tailscale专用网络中的其他网络设备

这是由于Docker默认的网络隔离机制导致的，容器无法直接访问宿主机专用网络的路由表。

解决方案

通过将SSHwifty容器与Tailscale容器共享网络命名空间，可以实现跨网络SSH连接。以下是完整的Docker Compose配置方案：

version: "3.7"
services:
  tailscale:
    image: tailscale/tailscale:latest
    container_name: tailscale
    hostname: docker
    environment:
      - TS_AUTHKEY=your_tailscale_auth_key
      - TS_STATE_DIR=/var/lib/tailscale
      - TS_USERSPACE=false
    volumes:
      - /path/to/tailscale/data:/var/lib/tailscale
    cap_add:
      - net_admin
      - sys_module
    ports:
      - 8080:8080
    restart: unless-stopped
  
  sshwifty:
    image: niruix/sshwifty
    container_name: sshwifty
    depends_on:
      - tailscale
    network_mode: service:tailscale

技术原理

1. Tailscale容器配置：

   • 使用官方Tailscale镜像
   • 设置必要的环境变量，包括认证密钥和状态目录
   • 添加网络管理权限(cap_add)
   • 映射SSHwifty服务端口(8080)

2. SSHwifty容器配置：

   • 使用官方SSHwifty镜像
   • 通过network_mode: service:tailscale与Tailscale容器共享网络栈
   • 依赖Tailscale容器启动(depends_on)

这种配置方式使得SSHwifty容器能够直接使用Tailscale容器的网络接口和路由表，从而访问Tailscale专用网络中的其他设备。

实施建议

1. 确保Tailscale认证密钥(TS_AUTHKEY)正确配置
2. 根据实际环境调整数据卷挂载路径
3. 如需使用不同端口，同步修改Tailscale和反向代理的端口配置
4. 在生产环境中考虑使用更安全的密钥管理方式

总结

通过Docker Compose将SSHwifty与Tailscale容器网络共享，可以优雅地解决跨网络SSH连接问题。这种方案不仅适用于家庭网络环境，也可以应用于企业级的多网络SSH访问场景，为远程设备管理提供了便利的Web界面访问方式。