Quick Start⚓︎
1 Install JumpServer⚓︎
- Supports mainstream Linux distributions (based on Debian / RedHat, including domestic operating systems)
- Refer to Linux standalone installation and deployment guide for quick JumpServer deployment
After successful installation, access and log in to JumpServer via browser
Address: http://<JumpServer server IP>:<service port>
Username: admin
Password: ChangeMe
2 Asset Management⚓︎
2.1 Preparation⚓︎
- Prepare two test assets and one database to verify functionality.
| IP Address | Hostname | Port | Operating System | Admin User | Password |
|---|---|---|---|---|---|
| 172.16.80.11 | test_ssh01 | 22 | Centos 7 | root | Test2020.L |
| 172.16.80.21 | test_rdp01 | 3389 | Windows 10 | administrator | Test2020.W |
| 172.16.80.31 | test_mysql01 | 3306 | MySQL 5 | root | Test2020.M |
Note
- Windows assets need Windows SSH setup before executing automation tasks such as
update asset informationandconnectivity testing; this is not required for logging in to Windows assets. - MySQL application requires granting
CoreandKoKoremote access permissions MySQL requirements
2.2 Edit Asset Tree⚓︎
- Click
Asset Management-Asset Liston the left side of the page. Right-click on the root nodeDefaultto create three nodes:SSH Server,RDP Server, andDatabase.
- Asset tree example:
Default
├─ SSH Server
└─ RDP Server
└─ DB Server
Note
- The root node
Defaultcannot be renamed. Right-click on nodes toadd,delete, andrenamenodes, and perform asset-related operations.
2.3 Create Assets⚓︎
- Click
Asset Management-Asset List-Hosts-Createto create a Linux server, and during asset creation, create a privileged user with theadmin userandpasswordfrom the table above. - The creation process for Windows assets is the same.
- Example of creating a Linux asset:
| Name | IP/Hostname | Asset Platform | Node | Protocol Group | Account List |
|---|---|---|---|---|---|
| test_ssh01 | 172.16.80.11 | Linux | /Default/SSH Server | ssh 22 | Add |
- Example of adding login asset user:
| Name | Username | Privileged User | Cipher Type | Password |
|---|---|---|---|---|
| 172.16.80.11_root | root | Yes | Password | Test2020.L |
Note
Namemust be unique. Eitherpasswordorkeyis required; some assets may not allow password authentication and can use key authentication instead.Privileged useronly supportsSSHprotocol, used for assetconnectivity testing,user push,batch password changeand other automation tasks.- If assets cannot connect normally, verify the privileged user's
usernameandpasswordare correct and theprivileged usercan SSH fromJumpServerhost to the asset host.
2.4 Create Database Application⚓︎
- Click
Asset Management-Asset List-Create-Databaseand selectMySQL Database.
- Example of creating a MySQL database application:
| Name | IP/Hostname | Node | Username | Database | Account List |
|---|---|---|---|---|---|
| test_mysql01 | 172.16.80.31 | /Default/DB Server | test | mysql:3306 | Add |
- Example of adding database login user:
| Name | Username | Password | Cipher Type | Password |
|---|---|---|---|---|
| 172.16.80.23_root | root | root | Password | Test2020.M |
Note
- Name, hostname, and database are required fields.
3 Create Authorization Rules⚓︎
- Click
Permission Management-Asset Authorization-Createto create an authorization. - The authorization process for Windows assets and MySQL databases is the same as below.
- Example of creating a login authorization rule (e.g., Linux asset):
| Name | User | User Group | Asset | Node | Account | Action |
|---|---|---|---|---|---|---|
| admin_ssh01 | Administrator(admin) | - | test_ssh01(172.16.80.11) | - | All accounts | ✓ All |
Note
Name: The authorization name, must be unique.User (Group)andAsset (Node)have a one-to-one relationship, so when you have different asset types likeLinuxandWindows, you should create separateauthorization rulesfor each.
4 User Login⚓︎
- Click
Web Terminalin the top-right corner to connect to assets.
Note
- Users can only see assets they have been authorized by administrators. If no assets appear after login, please contact your administrator.
5 System Settings⚓︎
- Click
System Settingsin the top-right corner to configure.
5.1 Basic Settings⚓︎
| Item | Default | Description |
|---|---|---|
| Forgotten password URL | Customize if using external authentication systems like LDAP, OpenID |
5.2 Email Settings⚓︎
- We support integrating email configuration through
SMTPorEXCHANGE.