仓库 →

Remote Access

By default the AtomCode webui only listens on loopback (127.0.0.1), so your phone and other devices can't reach it. With a virtual LAN built by 蒲公英 (Oray PGY) you can open the webui from a phone or tablet securely — no public IP, nothing exposed to the internet. This page walks through the full connection flow and the security notes.

How it works

蒲公英 is a remote-networking tool. Once it's installed on both this machine and your phone, signed into the same account and joined to the same network, the two devices sit on one virtual LAN and can talk over a 蒲公英 virtual IP. As long as the webui is bound to that virtual IP, your phone can reach it. The whole link is a private peer-to-peer network — your machine is never exposed to the public internet.

Why not just open it to the internet

The webui / daemon has no built-in authentication; whoever reaches it effectively gains execution rights for every tool on your machine (including bash, write, edit). So do not use --host 0.0.0.0 to expose it to the public internet or an open LAN. The 蒲公英 virtual LAN plus a one-time access token is the safe remote path intended for regular users.

Prerequisites

Steps

1. Connect 蒲公英 and get the virtual IP

Sign in and join the network in the 蒲公英 client on this machine, then note the virtual IP assigned to it (looks like 10.x.x.x). On the phone, just sign into the same account and join the same network — no IP to remember.

2. Bind the webui to the virtual IP

By default the webui binds loopback only, which your phone can't reach. In the AtomCode TUI, relaunch the webui with --host pointed at the 蒲公英 virtual IP:

/webui --host 10.x.x.x

Replace 10.x.x.x with the virtual IP you noted above. Once bound, the webui is reachable from any device on the same virtual LAN.

3. Scan to connect from the Remote Access panel

Open the Remote Access panel (the phone icon) in the top-right of the webui. AtomCode detects the 蒲公英 status and produces:

Scan the QR with your phone, or copy the URL into the phone's browser. The phone must be signed into the same 蒲公英 account and on the same network.

The access token is a password

The remote URL carries a one-time access token (?token=…) that is equivalent to a password: anyone who gets the full link can operate your machine. Don't post it in chats, screenshot it out, or paste it on a public page.

Troubleshooting

The Remote Access panel shows different hints depending on what it detects. Map them as follows:

Panel hintMeaningWhat to do
蒲公英 not detected 蒲公英 isn't installed, or the client isn't running. Install and sign into 蒲公英 on both machine and phone, join the same network, then hit "Re-check".
No virtual IP yet 蒲公英 is installed but hasn't joined a network. Connect / join the network in the 蒲公英 client, get a virtual IP, then "Re-check".
webui bound to localhost only 蒲公英 is detected, but the webui still listens on loopback. Relaunch with /webui --host <virtual IP> as in step 2, then refresh this page.
Phone can't open it / hangs The two ends aren't on the same network, or a firewall blocks it. Confirm both devices share the same 蒲公英 account and network; check that the machine's firewall allows the webui port.

Next