How to test and run AnQiCMS program under Windows environment?

As an experienced CMS website operation personnel, I am well aware of the importance of efficiently testing and running CMS programs in a local environment, especially on Windows systems, for content creation and optimization processes.AnQiCMS is a system developed based on the Go language, which is lightweight and efficient, and the deployment and testing in the Windows environment are also relatively convenient.Below, I will elaborate on how to test and run the AnQiCMS program in a Windows environment.

Test and run AnQiCMS program under Windows environment

AnQiCMS provides strong support for content operations with its simple and efficient architecture.For operators who need to edit content locally, develop templates, or perform functional testing, deploying it on Windows is an ideal choice.Here are the detailed steps and precautions to ensure you can test and run AnqiCMS smoothly on Windows.

1. Preparation

Before starting the deployment of AnQiCMS, we need to make sure that your Windows system meets the basic requirements.AnQiCMS supports Windows 10, Windows 11, and Windows Server 2016 and above versions.It is not compatible with Windows 7 or Windows Server 2012 and below versions.

Secondly, since AnQiCMS is a content management system, it requires a database to store all content and configuration information.Under Windows environment, MySQL database is commonly used.If you have not installed MySQL yet, please install it in advance.During the initialization installation of AnQiCMS, you need to provide the database connection information.

2. Obtain and run AnQiCMS program

First, you need to download the installation package for Windows systems from the official AnQiCMS website. Please visit the official download page, find and downloadanqicms-windows-vX.X.X.zipthe file, whichX.X.XRepresents a specific version number.

After the download is complete, extract the compressed file to a local directory of your preference, such asC:\anqicms. After extraction, you will see a folder namedanqicms.exeThe executable file and other related program files and directories.

To start AnQiCMS, simply double-click the extracted directory.anqicms.exeFile. After the program starts, you will not see any graphical interface window, as it is a background-running service.

3. Initial Installation and Access

After the AnQiCMS program successfully starts, you can access it through a web browser. Enter it in the address bar of the browser.https://en.anqicms.comYou can access the front-end page of the website. When you visit for the first time, the system will guide you to the initialization installation interface of AnQiCMS.

On this installation interface, you need to fill in the database connection information (such as database address, port, username and password), and set your background administrator account and password, as well as specify the website access address.Ensure that the database information you enter is accurate and that the administrator password is sufficiently complex for security.After completing these settings, click the install button to complete the initialization deployment of AnQiCMS.

After the initialization installation is successful, you canhttps://en.anqicms.com/system/Visit the backend management interface, log in with the administrator account and password you just set up, and start content management and website configuration.

Use the local development environment management tool (optional but recommended)

In order to better develop and test locally in the Windows environment, you can combine some local web service integration environments, such as the Windows version of PHPStudy (Xiao Pi Panel) or Baota Panel.These tools can help you manage services such as Nginx, MySQL, and configure local domains and reverse proxies, simulating a real production environment.

Taking PHPStudy as an example, the configuration steps are as follows:

1. Install PHPStudy:First, install PHPStudy on your Windows system.

2. Create a site:In the PHPStudy interface, create a new website. You need to specify a local domain name (such asdev.anqicms.com）and the website root directory. To be compatible with the AnQiCMS structure, you can set the website root directory to the unpacking path of AnQiCMS.publicdirectory one level up, for exampleC:/phpstudy_pro/WWW/dev.anqicms.com/Then include all files of AnQiCMS (includinganqicms.exe) copy them to this directory.

3. Configure Nginx reverse proxy:In the PHPStudy website settings, find and edit the Nginx configuration file for the corresponding site (usuallyvhosts.conf) atlocation / {Within the code block, add the reverse proxy rule for AnQiCMS, forwarding all requests to the default 8001 port where AnQiCMS is running. The specific configuration example is as follows:

   location @AnqiCMS {
       proxy_pass https://en.anqicms.com;
       proxy_set_header   Host             $host;
       proxy_set_header   X-Real-IP        $remote_addr;
       proxy_set_header   X-Forwarded-For  $proxy_add_x_forwarded_for;
   }
   location / {
      try_files $uri $uri/index.html @AnqiCMS;
   }
   

   Save the configuration and restart the Nginx service of PHPStudy.

4. Modify the Hosts file:In order for your local domain namedev.anqicms.comPoint to the local AnQiCMS service, you need to add a record in the Windowshostsfile. OpenC:\Windows\System32\drivers\etc\hostsfile, add127.0.0.1 dev.anqicms.com.

5. Run AnQiCMS:Double-clickanqicms.exeStart the program. Now, you can go throughhttp://dev.anqicms.comAccess your local AnQiCMS site.

V, Stop the AnQiCMS program

due toanqicms.exeRunning as a background service, you cannot close its window directly. To stop AnQiCMS, you need to use the Windows Task Manager.

PressWin + Rto input the combination key,taskmgrPress Enter to open Task Manager. Or, you can right-click on the taskbar and select Task Manager.In the Task Manager, switch to the "Details" or "Processes" tab, find the one namedanqicms.exeThe process. Select the process, then click the 'End Task' button at the bottom right to safely stop the AnQiCMS program.

Frequently Asked Questions (FAQ)

Is it normal that no window is displayed after the AnQiCMS program runs?Yes, this is completely normal. AnQiCMS usually runs in the background service mode on Windows, it will not open any visible graphical user interface window.You can access byhttps://en.anqicms.comOr you can configure the local domain to confirm that the program is running and access its front-end or back-end interface.

How do I configure a custom domain instead of using it when testing AnQiCMS locally?127.0.0.1?If you want to use a custom domain (such asdev.anqicms.com）To access the local AnQiCMS, you need to perform two steps.First, configure the domain in your local development environment tools (such as PHPStudy) and set up Nginx reverse proxy to forward requests to the port where AnQiCMS is running (default is 8001).Secondly, you need to do in Windows'hostsAdd a record in the file, map your custom domain to the local IP address127.0.0.1.hostsFiles are usually locatedC:\Windows\System32\drivers\etc\directory.

If AnQiCMS fails to start or is inaccessible, how should I troubleshoot the problem?First, checkanqicms.exeWhether it has already run in the task manager. If not running, try to double-click to restart.Next, check for port conflicts, AnQiCMS uses the default port 8001, make sure that port is not occupied by other programs.On Windows, you can usenetstat -anoCheck port usage in the command line. Additionally, during the initialization installation process, please carefully check the MySQL database connection information (address, port, username, password) you enter, as any error may cause the system to fail to start.If PHPStudy or similar tools are used, it is also necessary to ensure that the Nginx reverse proxy configuration is correct and that the PHPStudy service is running normally.