Installing Jianghu Panel

12007

1. Installation Environment

• Environment Preparation
  The environment for installing the Jianghu Panel requires you to have a running server or virtual machine. You can choose to deploy the Jianghu Panel on this server or virtual machine for installation, configuration, and management. Ensure that the server or virtual machine meets the system and hardware requirements of the Jianghu Panel and has a reliable network connection for the panel services to operate normally.

Reference articles: Understanding Servers, Enabling Servers

• Installation Commands and Steps

1. Open the terminal. If you are not logged in as the root user, you need to execute the following command to gain root privileges:

su root

2. Use the following command to download and install the Jianghu Panel:

International Source:

wget -O install.sh https://raw.githubusercontent.com/jianghujs/jh-panel/master/scripts/install.sh && bash install.sh

Domestic Source:

wget -O install.sh https://gitee.com/jianghujs/jh-panel/raw/master/scripts/install.sh && bash install.sh cn

3. Follow the prompts to complete the installation. Once finished, it will automatically start the panel and print out the panel information. You can access the Jianghu Panel using the address printed out in the panel information.

Note: Remember the login information for the Jianghu Panel during this step.

2. Logging into the Jianghu Panel and Initial Configuration

• Login

Copy the panel link, open it in a browser, enter your username and password, and log into the panel.

• Installing Recommended Plugins

After logging in, a prompt will appear recommending plugins to install. Select the necessary software for installation, with the recommended option being [One-Click Install]:

• OpenResty: Web server
• MySQL 5.7: MySQL database
• Xtrabackup: Backup for MySQL database
• NodeJS Manager: Node.js manager, includes node.js, npm, and nvm
• JianghuJS Manager: Manage JianghuJS projects

After installation, the plugins you just installed will appear in the left sidebar of the panel page:

• Installing Optional Plugins

You can also view and install more plugins through the software management menu. Commonly used plugins include:

• Xtrabackup Incremental: Supports incremental backups
• Docker: Containerization platform for rapid deployment, running, and managing applications
• NFS Manager: Configure and manage network file systems
• Rsyncd: Daemon for file synchronization and backup
• SSH Terminal: Quick access to the terminal

You can check the progress of software installation through the task list at the top of the left sidebar:

3. Panel Settings

• Basic Settings

In the left sidebar, select "Panel Settings" to view various settings of the Jianghu Panel. You can try modifying the following configurations here:

• Alias

• Server IP

• Panel Port: Default value is 10744

• Security Entry, Panel User, and Panel Password

• Security Settings
  To enhance the security of the Jianghu Panel, it is generally recommended to access the panel via HTTPS. This requires enabling the panel's SSL settings:

After enabling the panel's SSL settings, the browser will automatically redirect to access the panel via HTTPS. Typically, when you first access the panel via HTTPS, you will see a page similar to the one below in your browser:

You just need to find the "Proceed to" link and click it to go to the Jianghu Panel.

4. Jianghu Panel Directory Structure

• Importance of File Standards

Linux systems follow certain directory structure standards (such as the Filesystem Hierarchy Standard, FHS), which helps maintain organization and consistency within the system. Adhering to these standards ensures that both users and programs can find their expected files and directories, facilitating secure and efficient file and directory management.

• Directory Structure and Overview

The main program of the Jianghu Panel and the data for various applications are stored in the /www directory. In a typical server, the /www directory structure is as follows:

/www
├── backup
|   ├── database
│   └── site
├── recycle_bin
├── server
|   ├── cron
|   ├── jh-panel
|   ├── jianghujs
|   ├── mysql-apt
|   ├── nodejs
|   ├── openresty
|   ├── source
│   └── web_conf
├── wwwlogs
├── wwwroot
└── wwwstorage (optional)

In the above directory, the overview of each directory is as follows:

• /www/backup: Stores backup data for the server
• /www/recycle_bin: Recycle bin. This directory cannot be deleted
• /www/server: The main storage directory for various software and plugins required by the Jianghu Panel. Each directory under it corresponds to an installed plugin. The most important directories are:
  • /www/server/jh-panel: Storage directory for the main program of the Jianghu Panel
  • /www/server/web_conf: Storage directory for websites within the Jianghu Panel
  • /www/server/source:
  • /www/server/cron: Storage directory for scheduled tasks
• /www/wwwlogs: Stores access logs for various websites
• /www/wwwroot: Stores code, configuration files, and runtime logs for various projects and websites
• /www/wwwstorage: Stores user data for various projects.