Remote Support

Remote Support lets an XProxy technician connect to your server using a short support code (PIN) — no port forwarding, no TeamViewer, no IP address needed. It is unattended: the technician works on your XProxy box in the background, so you don't need to stay at your computer and nothing moves on your screen. You start a session, share the code, and stop it when we are done.

Get me connected — pick your path

Answer the questions below and we show you only the steps that apply to you.

Can you open your XProxy dashboard in a browser?

Install the tool (one line)

The tool is called xtool. Pick your operating system, copy the line, paste it into a terminal, done.

Windows
irm https://x-proxy.io/xtool.ps1 | iex

Open PowerShell (Win key → type "powershell" → Enter), paste this line, press Enter.

Share from the dashboard

Open your XProxy dashboard → System → Remote Support → click Start Remote Support → confirm → a 5-digit PIN like 48213 appears with a Copy to give to supporter button. Paste it to us in chat.

Don't see Remote Support under System? Update to v21.2.15 or newer: System Information → Force update. If that doesn't work, contact support.

Start Remote Support confirmation dialog
Confirm dialog — click Start.

Share from a terminal instead

On the XProxy box itself: xtool sp. From another computer on the same network: xtool sp (scans and lists servers) or xtool sp 192.168.x.x (direct IP — works for any port too: xtool sp 192.168.x.x:3389).

What you will see
╭─────────╮
│  21248  │
╰─────────╯
  copied to clipboard — paste it to the technician

While we work

You don't need to stay. The technician works on the XProxy box's command line from their side — nothing moves on your screen. See what unattended support means.

End the session

When the technician is done, any of these closes it instantly:

  • Click the red Stop Support Session button on the dashboard (same page you started it), or
  • Press Ctrl + C in the terminal window, or
  • Run xtool sp stop in another terminal.

Stopping closes the tunnel on your box and removes our access keys — the code cannot be used again. Sessions do not end on their own (on the XProxy box they even resume after a reboot), so stop it once we tell you we are done.

Optional — remote desktop (RustDesk)

If the technician needs to see your screen instead of a terminal, they may ask you to start a RustDesk session. One command installs RustDesk (if missing) and prints your ID:

Terminal
xtool rd

To set a fixed password so reconnects do not need a new code: xtool rd <password>.

Send the RustDesk ID shown to the technician. RustDesk connects peer-to-peer/relay — no firewall changes needed on your side.

Unattended support — what to expect

This is not screen sharing. If you used TeamViewer or UltraViewer before, you could watch the mouse move. Here the technician logs in to the XProxy box's command line from their own computer, so there is nothing to watch on yours.

TeamViewer / UltraViewerXProxy Remote Support
What we accessYour computer's screenOnly the XProxy box (command line)
Your computerFully controlledNot accessed — at most it relays one connection to the box
Do you need to stay?YesNo — it runs in the background
What you seeMouse and windows movingNothing on screen — changes appear in your dashboard
How it endsClose the appStop button on the dashboard, or xtool sp stop

How do I know if a technician is connected?

  • Session open or not: Dashboard → System → Remote Support shows the active session and its PIN. In a terminal: xtool sp status.
  • Someone logged in right now: run who on the box. A login from 127.0.0.1 is the support tunnel.
  • Every past login: grep Accepted /var/log/auth.log lists each login with date and time.

How do I remove access?

Click Stop Support Session on the dashboard, or run xtool sp stop. This closes the tunnel, removes our SSH keys from the box, and turns off resume-after-reboot. The session does not expire by itself, so always stop it when the work is done.

Started it from a Windows or Mac computer?

  • Your computer is only a relay. xtool forwards one connection to the XProxy box you picked (for example 192.168.1.50:22). Nothing on your computer — screen, files, browser — is shared.
  • Access exists only while the window is open. The xtool window is the session. Press Ctrl + C or close the window → the code stops working. While the computer sleeps or is shut down, nobody can connect.
  • Your password stays with you. If you type the box's username and password, xtool uses them only on your computer to add a temporary key to the box. The password is never sent to XProxy, and the key is removed when you stop.
  • Nothing keeps running afterwards. No service, no auto-start. Delete xtool anytime.

How it works

Your XProxy boxchisel + SSH server
XProxy relays.xproxy.ioport = your PIN
TechnicianXProxy support team
Your box calls out to our relay. The technician reaches the box only through that tunnel — nothing is opened on your router, and stopping the session cuts it.
  1. Start. You click Start Remote Support (or run xtool sp). The box registers with xproxy.io and receives a PIN.
  2. Tunnel out. The box opens one outgoing, encrypted connection to s.xproxy.io on port 8443 using chisel, an open-source tunnel. No incoming port is opened, so it works behind any router or CGNAT.
  3. Technician connects. xtool sp <PIN> is an SSH login to the relay on port = PIN. The relay passes it through the tunnel to the SSH server on your box.
  4. Key check. Your box accepts only the XProxy support keys added for this session (tagged xproxy-support-<PIN> in authorized_keys). The PIN alone does not log anyone in.
  5. Stop. The tunnel closes, the keys are removed, and the PIN stops working.
TechnologyRole
chisel (open source)Outgoing tunnel from your box to the relay — WebSocket over HTTPS, with SSH encryption inside. Downloaded from the official release and checksum-verified.
OpenSSHThe box's normal SSH server. Key-based login; every login is written to the box's own system log.
XProxy relay s.xproxy.ioConnects the technician to the right tunnel by PIN (ports 21000–21999). Holds no access to your box without a session.
xproxy.io APIIssues and revokes PINs, and records which technician connected and when.

Is it safe?

  • You start it. Nobody can connect until you start a session and hand over the code.
  • The PIN is not a password. Logging in also needs an XProxy support SSH key, which is added only for your session.
  • You end it. Stop the session → tunnel closed, keys removed, code dead.
  • No incoming connections. Your server makes one outgoing connection to XProxy's relay — works behind any router, CGNAT, or firewall that allows normal web browsing.
  • Your computer is not accessed. We work only on the XProxy box. xtool is one small program you can delete anytime.

Troubleshooting

ProblemFix
No Remote Support menu in the dashboardYour XProxy is older than v21.2.15. Open System Information → Force update, wait for it to finish, reload the dashboard. If the menu is still missing or the update fails, contact support on Telegram.
"Code not found or expired"The session was stopped or expired. Run xtool sp again for a fresh code.
"Failed to establish tunnel"Your network blocks outbound port 8443. Try another network or contact us.
Windows shows "Windows protected your PC"Click More info → Run anyway. The tool is unsigned but safe — or install via the PowerShell line above which avoids the warning.
"Access is denied" / permission error on WindowsThe installer writes only to %LOCALAPPDATA% — no admin needed. If it still fails, antivirus is blocking the download; allow it or contact us.
"Permission denied" installing on Mac/LinuxThe installer tries /usr/local/bin first, then falls back to ~/.local/bin — no sudo needed for the fallback. Run the plain command again; use sudo only if your admin wants a system-wide install.
Corporate PC blocks installs entirelyNo install needed — the technician can start a session from the XProxy dashboard (System → Remote Support) directly on the XProxy box.
No servers found by xtool spPass the server's IP directly: xtool sp 192.168.x.x.

For technicians

Connect with a PIN
xtool sp <pin>                  # interactive shell
xtool sp <pin> -e "cmd"        # run one command
xtool sp <pin> -D 1080         # SOCKS5 proxy via the box
ssh -p <pin> [email protected]  # zero-install fallback

Full command reference: xtool sp -h and dashboard access guide.

Need help? Talk to a technician

Message our support on Telegram — we reply in minutes during business hours.

Contact @xproxyio