Toggle navigation


XAMPP镜像手册(Windows)

Version 3.2.2

由Websoft9提供的XAMPP集成包是一个经典的、界面可视化的建站集成软件包,预装了Apache,MySQL,PHP、PHPMyAdmin以及其他必要组件,帮助您在Windows下快速的安装应用。

XAMPP Stack(Linux/Windows-Apache-MySQL-PHP-Perl)集成包是全球最流行的Web运行环境之一,基于免费、开源软件构建。框架中包括:Linux或Windows操作系统,Apache Web服务器软件、Tomcat Web服务器软件,MySQL数据库,Java、Perl、PHP编程语言等多种核心组件以及其他相关辅助组件。通过组合、优化和兼容性处理,将所有组件打包成一个高性能、高集成性的Web运行环境解决方案包,保证能够兼容运行绝大部分PHP应用程序。


本文档适用于通过主流云市场购买和部署了Websoft9镜像的用户,文档内容重点指导用户进行安装配置、系统基本操作和常见运维问题处理。

主流云平台包括:阿里云、腾讯云、百度云、华为云、Azure、青云

Websoft9的XAMPP镜像由运行环境、数据库和运维面板三个部分组成,本镜像完全以最新版本镜像为例包括:

网站目录
默认的网站根目录为:C:\xampp\htdocs
默认的网站根目录可以通过修改:C:\xampp\apache\conf\http.conf中的DocumentRoot相关部分

PHP运行环境(PHP 7.0,Apache 2.4)
PHP配置文件目录: C:\xampp\php\php.ini
Apache虚拟主机文件目录: C:\xampp\apache\conf\extra\httpd-vhosts.conf
Apache日志文件:请通过XAMPP面板查看

Java运行环境(JDK1.8,Tomcat7.0)
Tomcat安装目录:C:\xampp\tomcat
JavaApache安装目录: C:\Program Files (x86)\Java
Tomcat日志文件:请通过XAMPP面板查看
Tomcat Manager App:请通过http://ip/9panel的运维工具进入(登录账号:tomcat/tomcat)

数据库(MySQL5.6)
MySQL安装目录: C:\xampp\mysql
数据库账号密码参考“常见账号和密码说明”章节
数据库面板访问:http://公网IP/phpmyadmin

运维面板(9panel)
9Panel是Websoft9根据镜像用户的习惯和技术能力而研制的轻量级面板,以帮助用户快速掌握程序安装和运维工作
访问路径:http://服务器公网IP/9panel

  1. 镜像需要与服务器配套使用,获取Websoft9的镜像有两种方式:
    方式一:若没有可用的云服务器,登录主流云厂商的云市场,找到由Websoft9提供的“XAMPP”相关免费镜像,点击“购买”(同时会配套购买云服务器,若只打算试用请选择“按量”方式购买,实现按小时使用,接近免费)
    方式二:登录到云厂商的控制面板,找到可用的云服务器,通过更换系统盘(重装镜像)的方式
  2. 待镜像购买或更换完成后,镜像会自动安装到配套的云服务器上,待云服务实例处于“运行中”后,
    http://服务器公网IP/9panel,正常会出现如下界面:
  3. 如果浏览器访问以上网址没有任何反应,请检查您的安全组设置,确保80端口是开放的。

应用程序安装、使用和维护中需要用到二种账户:

1、MySQL数据库默认账号和密码:root/123456,管理地址:http://ip/phpmyadmin

2、Tomcat面板:tomcat/tomcat,管理地址:http://ip:8080/manager/html


2、Windows服务器操作系统账号和密码

  • 账号:administrator
  • 密码:是安装镜像的时候客户自行设置的,若不记得此密码,请登录云服务器后台,修改服务器密码,重启后生效
  • 登录:通过本地PC的远程桌面连接工具,参考(服务器通用文档-Windows远程管理与FTP

Windows服务器的操作主要分为两个部分:

  • 远程桌面连接:通过PC自带的远程桌面工具远程连接到服务器,完全控制服务器的操作,直接通过拷贝和粘贴的方式上传文件
  • FTP文件管理:通过FTP客户端和Windows服务器上的FTP服务端进行通讯,实现文件管理的操作的目的

具体参考:

9Panel是Websoft9公司自主研发的快捷面板工具,9Panel面板主要是集成数据库管理工具、系统运维工具、文档和支持服务入口,重点在于连接知识库和服务,几乎不会占用系统资源,也不会对系统文件进行任何修改。

通过chrome或Firefox浏览器访问:http://ip/9panel,即可进入面板页面。如果没有完成应用程序的安装,请根据面板的提示完成应用程序的安装。

XAMPP环境中部署网站主要分为5个步骤:

上传网站代码->配置域名(根据情况而定)->增加网站对应的数据库(根据程序要求而定)->完成安装向导

XAMPP环境中只部署一个网站还是多个网站、有无域名这两种情况对应的部署操作细节略有不一样,下面分别说明:

场景一:服务器只安装一个网站

  1. 远程桌面,将网站源文件拷贝到默认的根目录下:C:/xampp/htdocs
  2. 如果没有可用域名,请直接通过http://公网ip  的方式来访问应用
  3. 如果有可用的域名,通过域名控制台将域名解析到服务器公网IP,确保解析成功,后通过http://域名 的方式来访问应用
  4. 如果在安装向导过程中提示数据库无法自动创建,需要通过http://ip/phpmyadmin 创建数据库

场景二:服务器部署多个网站(无域名)

无域名情况下,以部署第一个网站为例,具体操作如下:

  1. 远程桌面,将第一个网站目录上传到C:/xampp/htdocs 目录下面,假设应用程序目录命为“mysite1”
  2. 通过http://ip/mysite1 的方式来访问应用,进入安装向导
  3. 如果在安装向导过程中提示数据库无法自动创建,需要通过http://ip/phpmyadmin 创建数据库

安装第二个网站mysite2,操作步骤同样

场景三:服务器部署多个网站(共用一个域名)

以部署第一个网站为例,具体操作如下:

  1. 远程桌面,将第一个网站目录拷贝到C:/xampp/htdocs 目录下面,假设应用程序目录命为“mysite1”
  2. 通过域名控制台,将域名解析到服务器公网IP,确保解析成功才能进入下一步
  3. 通过http://域名 /mysite1 的方式来访问应用,进入安装向导
  4. 如果在安装向导过程中提示数据库无法自动创建,需要通过http://ip/phpmyadmin 创建数据库

安装第二个网站mysite2,操作步骤同样

场景四:服务器部署多个网站(多个域名)

服务器计划部署多个网站,且每个网站对应的域名都不一样,专业叫法为虚拟主机配置。以部署第一个网站为例,具体操作如下:

  1. 远程桌面,第一个网站目录拷贝到C:/xampp/htdocs 目录下面,假设应用程序目录命为“mysite1”
  2. 通过域名控制台将域名解析到服务器公网IP,确保解析成功进入下一步
  3. 修改http-vhosts.conf文件,增加下面的代码(请根据实际情况替换mysite1和www.mydomain.com)
    NameVirtualHost *:80
    
    <VirtualHost *:80>
    DocumentRoot "C:/xampp/htdocs/"
    ServerName localhost
    </VirtualHost>
    
    <VirtualHost *:80>
       ServerAdmin help@websoft9.com
        DocumentRoot "C:/xampp/htdocs/mysite1"
        ServerName www.mydomain.com
       ErrorLog "logs/www.mydomain.com-error.log"
        CustomLog "logs/www.mydomain.com-access.log" common
    
       <Directory "C:/xampp/htdocs/mysite1" >
        Options Indexes FollowSymLinks
      AllowOverride all
        Order allow,deny
         Allow from all
       </Directory>
    </VirtualHost>
  4. 重启Apache服务或重启服务器
  5. 通过http://域名 的方式来访问应用,进入安装向导
  6. 如果在安装向导过程中提示数据库无法自动创建,需要通过http://localhost/phpmyadmin 创建数据库

安装第二个网站mysite2,操作步骤同样

Websoft9镜像默认安装了可视化MySQL管理工具phpMyadmin,其安装目录: /usr/share/phpMyAdmin。

如何使用PhpMyAdmin数据库?

  1. 通过本地Chrome或Firefox浏览器,访问:http://服务器公网IP/9panel
  2. 点击左侧菜单的“数据库管理”项,会进入“登录PhpMyAdmin”链接
  3. 选择您需要的语言,然后输入root和对应的密码,然后登录到系统中

常见的数据库相关操作包括:
修改root密码、创建数据库、创建用户和权限设置、导入和导出等,具体参考《MySQL文档-PhpMyAdmin常见操作》

域名设置分为两个步骤:

步骤1:域名控制台解析域名

如果您的域名备案(大陆之外无需备案),可以通过云厂商的域名控制台进行域名解析,操作如下:

  1. 登录域名控制台->域名解析,进入解析设置界面(以阿里云为例)
  2. 增加一条A记录,主机记录那里填写二级域名的前缀(如www,shop,test等)或通配符@,记录值填写您的服务器公网ip地址,保存
  3. 域名解析成功,等待解析生效(不同的厂商解析生效时间不一样,1分钟-24小时不等)

注意:解析生效之后,本地访问可能由于缓存问题导致仍然没有生效,请清空浏览器缓存,然后通过CMD命令行刷新本地DNS操作

步骤2:修改虚拟主机配置文件(非必要)

XAMPP环境下,请远程桌面到服务器,打开C:\xampp\apache\conf\extra\httpd-vhosts.conf文件,将其中的ServerName,ServerAlias的值替换成你的域名信息,重启Apache服务后生效。

在设置https访问之前,请提前开启服务器安全组的443端口,如果不开启,https访问是不可用的

HTTPS访问配置(需自己准备证书)

如果您已经申请了证书(请保证证书可用),请参考如下的配置方式:

  1. 将证书上传到服务器证书目录:conf/ssl.*(*为目录后缀名)
  2. 打开C:\xampp\apache\conf\extra\httpd-ssl.conf配置文件
  3. 找到httpd-ssl.conf中的https配置内容模板(下面是去掉注释后的效果)
    <VirtualHost _default_:443>
    DocumentRoot "C:/xampp/htdocs"
    ServerName www.example.com:443
    ServerAdmin admin@example.com
    ErrorLog "C:/xampp/apache/logs/error.log"
    TransferLog "C:/xampp/apache/logs/access.log"
    
    SSLEngine on
    SSLCertificateFile "conf/ssl.crt/server.crt"
    SSLCertificateFile "conf/ssl.crt/server.crt"
    SSLCertificateFile "conf/ssl.crt/server.crt"
    
    #<Location />
    #SSLRequire (    %{SSL_CIPHER} !~ m/^(EXP|NULL)/ \
    #            and %{SSL_CLIENT_S_DN_O} eq "Snake Oil, Ltd." \
    #            and %{SSL_CLIENT_S_DN_OU} in {"Staff", "CA", "Dev"} \
    #            and %{TIME_WDAY} >= 1 and %{TIME_WDAY} <= 5 \
    #            and %{TIME_HOUR} >= 8 and %{TIME_HOUR} <= 20       ) \
    #           or %{REMOTE_ADDR} =~ m/^192\.76\.162\.[0-9]+$/
    #</Location>
    
    <FilesMatch "\.(cgi|shtml|phtml|php)$">
        SSLOptions +StdEnvVars
    </FilesMatch>
    <Directory "C:/xampp/apache/cgi-bin">
        SSLOptions +StdEnvVars
    </Directory>
    
    BrowserMatch "MSIE [2-5]" \
             nokeepalive ssl-unclean-shutdown \
             downgrade-1.0 force-response-1.0
    
    CustomLog "C:/xampp/apache/logs/ssl_request.log" \
              "%t %h %{SSL_PROTOCOL}x %{SSL_CIPHER}x \"%r\" %b"
    
    </VirtualHost>     
  4. 修改配置文件中相关项,并保存
    ServerName  #主域名,务必修改
    DocumentRoot #网站路径,务必填写网站实际路径,例如:C:/xampp/htdocs/wordpress
    SSLCertificateFile #证书File,务必填写网站实际路径
    SSLCertificateKeyFile #证书KeyFile,务必填写网站实际路径
    SSLCertificateChainFile #证书ChainFile,务必填写网站实际路径
    注意:证书的后缀一般是:.crt或者 .pem,私钥的后缀是:.key
  5. 重启Apache服务

证书FAQ

证书的申请注意事项:

  • 免费证书只能用于明细域名,例如: buy.example.com,或next.buy.example.com,
  • example.com是通配符域名方式,不能用于申请免费证书
  • 申请证书的时候,请先解析好域名,有些证书会绑定域名对应的IP地址,即一旦申请后,IP地址不能更换,否则证书不可用

与PHP相关的操作

如何修改PHP配置文件?

通过修改C:\xampp\php\php.ini即可修改php配置:

  • 何修改系统最大响应时间?将max_execution_time设置成你需要的值
  • 如何修改上传文件大小限制?将post_max_size = 64M,upload_max_filesize = 64M设置成你需要的值

修改后重启Apache

服务随操作系统自动启动,如果手工修改配置参数后,需要重新启停服务。

  • 方法一:远程桌面点击XAMPP图标,然后点击需要启动或停止的服务
  • 方法二:打开xampp安装的文件夹,点击对应的服务启停ext/bat文件
    Apache & MySQL start: \xampp\xampp_start.exe
    Apache & MySQL stop: \xampp\xampp_stop.exe
    Apache start: \xampp\apache_start.bat
    Apache stop: \xampp\apache_stop.bat
    MySQL start: \xampp\mysql_start.bat
    MySQL stop: \xampp\mysql_stop.bat
    Mercury Mailserver start: \xampp\mercury_start.bat
    Mercury Mailserver stop: \xampp\mercury_stop.bat
    FileZilla Server start: \xampp\filezilla_start.bat
    FileZilla Server stop: \xampp\filezilla_stop.bat

如何解决PHP的http-proxy漏洞?

升级php的小版本即可解决http-proxy漏洞

如何设置phpMyAdmin只允许在127.0.0.1访问?

镜像默认开启了phpMyAdmin远程访问,若想关闭之,请修改:C:\websoft9\wampserver\alias\phpmyadmin.conf

找到如下部分

 Alias /phpmyadmin "C:/xampp/phpMyAdmin/"
    <Directory "C:/xampp/phpMyAdmin">
        AllowOverride AuthConfig
        Require all granted
        ErrorDocument 403 /error/XAMPP_FORBIDDEN.html.var
    </Directory>

修改成

Alias /phpmyadmin "C:/xampp/phpMyAdmin/"
    <Directory "C:/xampp/phpMyAdmin">
        AllowOverride AuthConfig
        Require local
        #Require all granted
        ErrorDocument 403 /error/XAMPP_FORBIDDEN.html.var
    </Directory>

修改后重启Apache服务后生效

  • 官网:https://www.apachefriends.org/
  • FAQ:http://libs.websoft9.com/Websoft9/documents/xampp/dashboard/faq.html
  • 用户手册:http://libs.websoft9.com/Websoft9/documents/xampp/dashboard/howto.html

本文档由长沙网久软件有限公司原创,为了保证文档的严肃性和可用性,任何人不得盗用或修改后二次分发。需要的朋友们转载请标注来源,否则我们给予法律追究。

我们会定期更新文档,请访问在线文档以获取最新版本

本文档在线地址:http://www.websoft9.com/xdocs/xampp-image-guide
合作或技术支持:http://www.websoft9.com