As an experienced CMS website operation person, I am well aware of the importance of efficiently testing and running CMS programs locally, especially on Windows systems, for content creation and optimization processes.AnQiCMS as a system developed based on Go language, with its lightweight and efficient characteristics, 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 under the Windows environment.

Test and run AnQiCMS program under Windows environment

AnQiCMS with its concise and efficient architecture, provides powerful support for content operation.For operators who need to edit content, develop templates, or test features locally, deploying it on a Windows environment is an ideal choice.The following are detailed steps and precautions to ensure that you can test and run AnqiCMS smoothly on the Windows system.

1. Preparation

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

其次，since AnQiCMS is a content management system, it needs a database to store all content and configuration information.Under Windows, MySQL database is often 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

Firstly, 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.zip文件，其中X.X.XRepresents a specific version number.

After the download is complete, extract the zip file to a local directory of your preference, for exampleC:\anqicms. After extracting, 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, because it is a background-running service.

3. Initial Installation and Access

When AnQiCMS program is successfully started, you can access it through the browser. Enter it in the address bar of the browser.http://127.0.0.1:8001You 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.

In 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 access address of the website.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 initial deployment of AnQiCMS.

After the initialization installation is successful, you can accesshttp://127.0.0.1:8001/system/Visit the back-end management interface, log in with the administrator account and password you just set up, and start content management and website configuration.

Four, use the local development environment management tool (optional but recommended)

In order to better develop and test locally under the Windows environment, you can combine some local web service integration environments, such as the Windows version of PHPStudy (Xiaopi 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 root directory of the website. To be compatible with the structure of AnQiCMS, the root directory of the website can be set to the unzipped path of AnQiCMS.publicdirectory one level up, for exampleC:/phpstudy_pro/WWW/dev.anqicms.com/，然后将AnQiCMS的所有文件（包括English）复制到此目录。anqicms.exe）复制到此目录。

  3. 配置Nginx反向代理：In the PHPStudy website settings, find and edit the corresponding Nginx configuration file (usuallyvhosts.conf)。Inlocation / {The English translation of 'auto' is 'English'. Please provide the correct translation for the value in the JSON array.

    location @AnqiCMS {
    proxy_pass http://127.0.0.1:8001;
    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.comPointing to the local AnQiCMS service, you need to add a record in Windows.hostsAdd a record in the file. OpenC:\Windows\System32\drivers\etc\hostsAdd a file,127.0.0.1 dev.anqicms.com.

  5. Run AnQiCMS:Double-clickanqicms.exeStart the program. Now, you can accesshttp://dev.anqicms.comyour local AnQiCMS site.

5. Stop the AnQiCMS program

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

pressWin + Rkey combinations, and entertaskmgrPress Enter to open the Task Manager.or, you can right-click on the taskbar and select 'Task Manager'.anqicms.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 AnQiCMS does not display any window after running?Yes, that is perfectly normal.AnQiCMS in Windows environment usually runs in background service mode, it will not open any visible graphical user interface window.http://127.0.0.1:8001Or confirm whether the program is running and access its front-end or back-end interface by using the local domain name you have configured.

How to configure a custom domain instead of using when testing AnQiCMS locally127.0.0.1?If you want to use a custom domain (such asdev.anqicms.comTo access the local AnQiCMS, you need to perform two steps.First, configure the domain name 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).hostsAdd a record in the file, map your custom domain to the local IP address127.0.0.1.hostsFiles are usually located inC:\Windows\System32\drivers\etc\the directory.

If AnQiCMS fails to start or is inaccessible, how should I troubleshoot the problem?First, checkanqicms.exeIs it already running in the Task Manager.If not running, try to double-click to start.其次，check if there is a port conflict, AnQiCMS uses port 8001 by default, make sure that port is not occupied by other programs.netstat -anoThe command is used to check port occupation in the command line.In addition, during the initial installation process, please carefully check the MySQL database connection information (address, port, username, password) you entered. Any error may cause the system to fail to start.If PHPStudy and other tools are used, make sure that the Nginx reverse proxy configuration is correct and that the PHPStudy service is running normally.