Skip to content
Octoboard Docs

Browser over UU Remote

Open Octoboard in a browser on another computer through the port mapping of UU Remote, NetEase’s remote control app, without SSH or a remote desktop. The host is the computer that runs Octoboard; SSH sign-in (Remote Login on macOS) can stay off, and no remote desktop session is needed. UU Remote’s interface is in Chinese, so this guide gives its Chinese labels beside the English.

This guide opens Octoboard in a browser on your own computer. That’s sharper and more responsive than remote desktop, but takes more steps. If you don’t mind some lag and blur, simply use UU Remote’s remote desktop to work on the host directly.

Not sure this is the way for you? See Choose how to connect.

Browser on your computer → 127.0.0.1 on your computer ⟷ UU Remote ⟷ 127.0.0.1 on the host → Octoboard

New to this?
  • 127.0.0.1 (loopback): an address that always means “this same computer”.
  • Port: a number that picks one program on a computer, like a door number. 127.0.0.1:3369 is port 3369 on this computer.
  • Port mapping (端口映射): a UU Remote feature that makes a port on the host appear as a port on your own computer.
  • socat: a small, free program that passes a connection from one place to another. A Mac host needs it as a relay.
  • Terminal: the window you type commands into: Terminal on macOS, PowerShell on Windows.

UU Remote’s port mapping makes the host’s Octoboard appear on your own computer at 127.0.0.1, which is the only address Octoboard accepts a browser on.

  • Both computers are a Mac or a Windows PC. UU Remote has no port mapping for Linux; reach a Linux server through Tailscale or SSH instead.
  • Both have UU Remote installed and signed in to the same account, at version 4.21.0 or later on Windows and 4.32.0 or later on macOS. Port mapping works for TCP only, which is all Octoboard needs. At the time of writing, UU Remote lists port mapping among its free features; check its current plans if in doubt.
  • The host appears under My devices (我的设备) in UU Remote on the computer you’ll browse from.
  • A Mac host also needs Homebrew, to install socat below.
  1. Get the browser address, which carries the key that signs the browser in.

    In Octoboard, open Settings › Remote access, turn on Allow remote access and select Allow to confirm. Two tabs then appear below the switch. On the Browser tab, select Copy address under Step 2: Browser address.

    Get the address to the other computer in a way only you can read, such as a note to yourself: it works like a password.

    Skip Step 1: SSH forward. The app’s settings mention SSH in several places; you can ignore that here, since this guide uses only the browser address.

    Keep Octoboard running: if you quit it, remote access stops.

  2. Make a port on the host’s 127.0.0.1 that leads to Octoboard. This port is the host port in the steps below.

    A Mac serves the browser in a way UU Remote can’t map, so it needs socat as a relay. Install it in Terminal:

    Terminal window
    brew install socat

    Then run this and leave the window open. It listens on 127.0.0.1:3370 alone.

    Terminal window
    socat TCP-LISTEN:3370,bind=127.0.0.1,reuseaddr,fork UNIX-CONNECT:"$HOME/.octoboard/browser.sock"

    The host port is 3370.

  1. In UU Remote, open the host from My devices (我的设备), choose More (更多) on its card and then Port mapping (端口映射), and add a mapping:

    FieldValue
    Name (名称)Octoboard
    Local port (本地端口)3369
    Target address (目标地址)127.0.0.1
    Target port (目标端口)the host port

    Save and enable it, and wait until it shows as connected. If 3369 is taken on this computer, pick another local port and change it in the browser address too.

  2. Check that only this computer can use the mapping. Open Terminal (macOS) or PowerShell (Windows) on this computer and run:

    Terminal window
    lsof -nP -iTCP:3369 -sTCP:LISTEN

    You should see a line containing 127.0.0.1:3369 and LISTEN.

    If you see *:3369 or 0.0.0.0:3369 in its place, delete the mapping: other devices on your network could reach Octoboard.

  3. Open the browser address you copied on the host. It starts with http://127.0.0.1:3369/.

You’ll know it worked when Octoboard opens in the browser tab without asking you to sign in.

  • The mapping shows as connected, but the page doesn’t load: on a Mac host, the socat window was closed or its command stopped; or Allow remote access is off, or Octoboard isn’t running on the host.
  • The mapping won’t save or connect: the local port may be taken on this computer. Pick another one, and change it in the browser address too.
  • The page is refused or blank: check that you opened the address at 127.0.0.1.
  • On the computer you browsed from: switch the mapping off in UU Remote’s port mapping panel, or delete it. Closing the panel or disconnecting also stops it.
  • On a Mac host: stop socat with Ctrl+C.
  • On the host, turn off Allow remote access when you no longer need it. This closes the browser entry and disconnects every page opened with the key.
  • If the address may have leaked, give it a new key with Rotate key on the Browser tab. Pages open with the old address are disconnected.
  • The address is the password: its key gives full control of Octoboard on the host, running any command included. It lasts until you rotate it. It stays in the browser’s history and bookmarks, and syncs to your other devices if browser sync is on.
  • Who can reach it: anyone who reaches the host port and has the key. On the host it listens on 127.0.0.1 only; anyone who can use your UU Remote account to map ports to the host can reach it too, so keep that account secure.
  • Only on computers nobody else signs in to: another user account on the host or on your computer can connect to these 127.0.0.1 ports, and while the mapping or socat isn’t running it can take the port and receive the key when your browser reconnects. With Connect over SSH, a Mac or Linux host doesn’t have this weakness, and neither does your own computer when you use the desktop app. In a browser your computer still has it, because the SSH forward listens on a 127.0.0.1 port there too.