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:3369is 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.
Before you start
Section titled “Before you start”- 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.
On the host
Section titled “On the host”-
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.
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. Also note the number under Browser port.
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.
-
Make a port on the host’s
127.0.0.1that 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 socatThen run this and leave the window open. It listens on
127.0.0.1:3370alone.Terminal window socat TCP-LISTEN:3370,bind=127.0.0.1,reuseaddr,fork UNIX-CONNECT:"$HOME/.octoboard/browser.sock"The host port is
3370.Nothing to run: Octoboard itself listens on the browser port, on
127.0.0.1alone. The host port is the Browser port on the Browser tab (3369 unless you changed it).
On the computer you’ll browse from
Section titled “On the computer you’ll browse from”-
In UU Remote, open the host from My devices (我的设备), choose More (更多) on its card and then Port mapping (端口映射), and add a mapping:
Field Value Name (名称) Octoboard Local port (本地端口) 3369Target address (目标地址) 127.0.0.1Target 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.
-
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:LISTENYou should see a line containing
127.0.0.1:3369andLISTEN.Terminal window netstat -ano | findstr :3369You should see a line that starts with
TCP, then127.0.0.1:3369, and ends withLISTENINGand a number.If you see
*:3369or0.0.0.0:3369in its place, delete the mapping: other devices on your network could reach Octoboard. -
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.
If it doesn’t work
Section titled “If it doesn’t work”- 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.
Turn it off
Section titled “Turn it off”- 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.
Security
Section titled “Security”- 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.1only; 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.1ports, 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 a127.0.0.1port there too.