Alas remote access service

中文 | English

Control your alas in web browser

Usage

Find these in your ./config/deploy.yaml

RemoteAccess:
    # Enable remote access (using ssh reverse tunnel serve by https://github.com/wang0618/localshare)
    # ! You need to set Password below to enable remote access since everyone can access to your alas if they have your url.
    EnableRemoteAccess: false
    # Username when login into ssh server
    # [Default] null (will generate a random one when startup)
    SSHUser: null
    # Server to connect
    # [Default] null
    # [Format] host:port
    SSHServer: null    
    # Filepath of SSH executable `ssh.exe`
    # [Default] ssh (find ssh in system PATH)
    # If you don't have one, install OpenSSH or download it here (https://github.com/PowerShell/Win32-OpenSSH/releases)
    SSHExecutable: ssh

Webui:
    # --key. Password of web ui
    # Useful when expose Alas to the public network
    Password: null

Set EnableRemoteAccess to True
Set a Password to protect your alas
Select an SSHServer below

	`SSHServer`	Location	Note
`us1`	`app.us1.azurlane.cloud:10022`	United States/California
`hk1`	`app.hk1.azurlane.cloud:10022`	HongKong	❗️ CN only

Latency test http://app.azurlane.cloud/speedtest.html

Latency test is NOT speedtest，download speed is limited to about 4.5Mbps。

`SSHUser`

When SSHUser is null, a random username of length 24 is automatically generated when the remote service is started.
So you are not required to change this if there are no special circumstances.
⚠️ If there are multiple client use the same SSHUser, the newly connect one will take place of the old one, and the old one will not disconnect at that time. If you want to use your custom SSHUser, make sure it is unique.

Each connection generates a different location suffix, so remote connection address will change every time when alas restart or have an unstable connection to server.
So we use a modified localshare, where the ssh connection username is used as a token.
Using a username with length >= 8 will cache the remote connection address in server memory and the same location suffix will be assigned the next time you reconnect.

`SSHExecutable`

Remote access need an SSH client. Usually you will have one preinstalled in your Windows. But in case you don't have，install OpenSSH or download SSH from Github https://github.com/PowerShell/Win32-OpenSSH/releases (OpenSSH-Win64.zip)，unzip and get ssh.exe ，and copy file path to SSHExecutable or configure system PATH.

Download ssh.exe directly here.

Done

Restart alas, and finally you will see a link like https://app.us1.azurlane.cloud/abcdefghij in your Alas. Now you can use this link to get access to your alas.

As a free service, the number of token caches is limited and will be emptied after a reboot (update or maintain). There is no guarantee of a fixed location suffix, also no guarantee of service availability.