LinuxCommandLibrary

nxc-vnc

Remotely access graphical desktop using NX protocol

TLDR

Search for valid credentials by trying out every combination in the specified lists of usernames and passwords

$ nxc vnc [192.168.178.2] [[-u|--username]] [path/to/usernames.txt] [[-p|--password]] [path/to/passwords.txt]
copy

Avoid rate limiting through VNC-sleep
$ nxc vnc [192.168.178.2] [[-u|--username]] [path/to/usernames.txt] [[-p|--password]] [path/to/passwords.txt] --vnc-sleep [10]
copy

Take a screenshot on the remote system after waiting the specified amount of time
$ nxc vnc [192.168.178.2] [[-u|--username]] [username] [[-p|--password]] [password] --screenshot --screentime [10]
copy

SYNOPSIS

`nxc-vnc` [options]

PARAMETERS

`--help`
    Displays help information.

`--geometry x`
    Sets the resolution of the VNC session (e.g., `--geometry 1920x1080`).

`--depth `
    Sets the color depth of the VNC session (e.g., `--depth 24`).

`--dpi `
    Sets the DPI (dots per inch) of the VNC session. If not specified default DPI is used.

`--name `
    Specifies the name of the VNC session.

`--password `
    Sets the VNC password. If not given, you may be prompted.

DESCRIPTION

The `nxc-vnc` command is a wrapper script that simplifies the process of starting a VNC (Virtual Network Computing) server compatible with NoMachine's NX protocol. This allows users to remotely access a Linux desktop environment with improved performance compared to standard VNC, particularly over slower network connections. It automates the configuration of a VNC server with NX-compatible settings and handles the creation of necessary directories and configuration files. It aims to provide a user-friendly experience for setting up NX-based remote desktop access. It ensures a secure and efficient connection to a graphical desktop environment on a remote Linux machine, leveraging the benefits of the NX protocol for optimized performance.

CAVEATS

The `nxc-vnc` command relies on underlying VNC server software and the NX libraries being installed. Ensure these dependencies are properly configured before using the command. The specific available options and behavior may vary depending on the version and configuration of the `nxc-vnc` script and related software. The security of the connection depends on the strength of the VNC password and the underlying VNC server's security measures.

CONFIGURATION

The `nxc-vnc` command typically manages its configuration files in a dedicated directory, often within the user's home directory. These files store settings such as the VNC server port, display number, and NX-related parameters.
Important: Modifying these files directly without understanding their purpose can lead to unexpected behavior or security vulnerabilities. Consult the script's documentation or relevant resources for safe configuration practices.

TROUBLESHOOTING

Common issues encountered when using `nxc-vnc` include connection problems, authentication failures, and display errors.
Troubleshooting Tips:
1. Verify that the VNC server is running correctly using `ps aux | grep Xvnc`.
2. Check the VNC server logs for error messages. These are typically found in `~/.vnc` or a similar directory.
3. Ensure that the firewall is configured to allow connections to the VNC server port (usually 5900 + display number).
4. Double-check the VNC password and connection settings in your VNC client.
5. Try restarting the nxc-vnc process.

SEE ALSO

vncserver(1), nxserver(1)

Copied to clipboard