PuTTY

概述

PuTTY is a free and open-source terminal emulator, serial console and network file transfer application. It supports several network protocols, including SCP, SSH, Telnet, rlogin, and raw socket connection. It can also connect to a serial port. The graphical user interface (GUI) of the application can be accessed through a modern web browser, requiring no installation or configuration on the client side, or via any VNC client. The container is built against Alpine Linux to provide an efficient image in terms of size and resource usage. For a complete documentation of this container, see https://github.com/jlesage/docker-putty#readme

运行时参数

网络用户界面: http://[IP]:[PORT:5800]
网络: bridge
特权: false

模板配置

Config DirectoryPathrw

Stores the application's configuration, state, logs, and any files requiring persistency.

目标: /config
默认值: /mnt/user/appdata/putty

User IDVariable

ID of the user the application runs as.

目标: USER_ID
默认值: 99

Group IDVariable

ID of the group the application runs as.

目标: GROUP_ID
默认值: 100

UmaskVariable

Mask controlling permissions for newly created files and folders, specified in octal notation.

目标: UMASK
默认值: 0000

Niceness (priority)Variable

Priority at which the application should run. A niceness value of `-20` is the highest, `19` is the lowest and `0` the default. NOTE: Setting a negative value requires additional permissions. Thus, `--cap-add=SYS_NICE` must be added to Extra Parameters (shown when Advanced View is enabled).

目标: APP_NICENESS
默认值: 0

Display WidthVariable

Width (in pixels) of the application's window.

目标: DISPLAY_WIDTH
默认值: 1920

Display HeightVariable

Height (in pixels) of the application's window.

目标: DISPLAY_HEIGHT
默认值: 1080

Dark ModeVariable

When set to `1`, enables dark mode for the application.

目标: DARK_MODE
默认值: 0

Web AudioVariable

When set to `1`, enables audio support, allowing audio produced by the application to play through the browser.

目标: WEB_AUDIO
默认值: 0

Web File ManagerVariable

When set to `1`, enables the web file manager, allowing interaction with files inside the container through a web browser, supporting operations like renaming, deleting, uploading, and downloading.

目标: WEB_FILE_MANAGER
默认值: 0

Web File Manager Allowed PathsVariable

Comma-separated list of paths within the container that the file manager can access. By default, the container's entire filesystem is not accessible, and this variable specifies allowed paths. If set to `AUTO`, commonly used folders and those mapped to the container are automatically allowed. The value `ALL` allows access to all paths (no restrictions).

目标: WEB_FILE_MANAGER_ALLOWED_PATHS
默认值: AUTO

Web File Manager Denied PathsVariable

Comma-separated list of paths within the container that the file manager cannot access. A denied path takes precedence over an allowed path.

目标: WEB_FILE_MANAGER_DENIED_PATHS
默认值: None

Web Desktop NotificationsVariable

When set to `1`, enables the web notification service, allowing the browser to display desktop notifications from the application.

目标: WEB_NOTIFICATION
默认值: 0

Web TerminalVariable

When set to `1`, enables access to a terminal from the web interface. It is strongly recommended to configure the container with secure web access (HTTPS).

目标: WEB_TERMINAL
默认值: 0

Web AuthenticationVariable

When set to `1`, protects the application's GUI with a login page when accessed via a web browser. Access is granted only with valid credentials.

目标: WEB_AUTHENTICATION
默认值: 0

Web Authentication Token Validity TimeVariable

Lifetime of a token, in hours. A token is assigned to the user after successful login. As long as the token is valid, the user can access the application's GUI without logging in again. Once the token expires, the login page is displayed again.

目标: WEB_AUTHENTICATION_TOKEN_VALIDITY_TIME
默认值: 24

Web Authentication UsernameVariable

Optional username for web authentication. Provides a quick and easy way to configure credentials for a single user. For more secure configuration or multiple users, see the documentation.

目标: WEB_AUTHENTICATION_USERNAME

Web Authentication PasswordVariable

Optional password for web authentication. Provides a quick and easy way to configure credentials for a single user. For more secure configuration or multiple users, see the documentation.

目标: WEB_AUTHENTICATION_PASSWORD

Secure ConnectionVariable

When set to `1`, uses an encrypted connection to access the application's GUI (via web browser or VNC client).

目标: SECURE_CONNECTION
默认值: 0

Secure Connection VNC MethodVariable

Method used for encrypted VNC connection. Possible values are `SSL` or `TLS`.

目标: SECURE_CONNECTION_VNC_METHOD
默认值: SSL

Secure Connection Certificate Check IntervalVariable

Interval, in seconds, at which the system checks if web or VNC certificates have changed. When a change is detected, affected services are automatically restarted. A value of `0` disables the check.

目标: SECURE_CONNECTION_CERTS_CHECK_INTERVAL
默认值: 60

Web Listening Port (Non-Bridge Network Type)Variable

Port used by the web server to serve the application's GUI. This port is internal to the container and typically does not need to be changed. NOTE: This setting is relevant only when the Network Type is set to something else than Bridge.

目标: WEB_LISTENING_PORT
默认值: 5800

VNC Listening Port (Non-Bridge Network Type)Variable

Port used by the VNC server to serve the application's GUI. This port is internal to the container and typically does not need to be changed. NOTE: This setting is relevant only when the Network Type is set to something else than Bridge.

目标: VNC_LISTENING_PORT
默认值: 5900

WEB Port for GUI (Bridge Network Type)Porttcp

Port to access the application's GUI via the web interface. NOTE: This setting is relevant only when the Network Type is set to `Bridge`.

目标: 5800
默认值: 7816

VNC Port for GUI (Bridge Network Type)Porttcp

Port to access the application's GUI via VNC protocol. Optional if no VNC client is used. NOTE: This setting is relevant only when the Network Type is set to `Bridge`.

目标: 5900
默认值: 7916