用宝塔面板安装Matomo内部部署

Installing Matomo On-Premise 安装Matomo内部部署

This page explains how to install Matomo on your web server and start tracking your site web analytics. If you prefer to watch a video tutorial, click here: How to Setup Matomo Analytics (formerly Piwik Analytics) [Video] 本页介绍如何在您的Web服务器上安装Matomo并开始跟踪您的网站Web分析。如果您喜欢观看视频教程，请单击此处：如何设置Matomo Analytics（原Piwik Analytics）[视频]

Getting Started 入门

Before you get started, ensure that you have the following: 在开始之前，请确保您具备以下条件：

• A web server, shared hosting or dedicated server. If you do not have a web server or shared host to install Matomo on, you can get a pre-installed Matomo in minutes. Try the Matomo Cloud (formerly Piwik Cloud) service created by the makers of Matomo themselves. Web服务器、共享主机或专用服务器。如果您没有Web服务器或共享主机来安装Matomo，您可以在几分钟内获得预安装的Matomo。试试 Matomo云（以前的Piwik云）服务，该服务由Matomo的制造商自己创建。
• Access to your web server (via shell or FTP) 访问您的Web服务器（通过shell或FTP）
• If you have a WordPress website, we now have an easier and faster option for you to get the Matomo Analytics for WordPress plugin 如果您有一个WordPress网站，我们现在有一个更容易和更快的选择为您获得Matomo Analytics for WordPress插件
• A FTP Client (if you are installing Matomo on a remote server) FTP客户端（如果您在远程服务器上安装Matomo）

Check you meet the minimum requirements

检查您是否满足最低要求

Check to make sure that your web host meets the minimum requirements to run Matomo. 检查以确保您的Web主机满足运行Matomo的最低要求。

Download Matomo 下载Matomo

Download the latest release Matomo 4.14.1 from here: 下载最新版本Matomo 4.14.1 从这里：

Using WordPress? Try Matomo Analytics for WordPress! No technical setup required. 使用WordPress？尝试Matomo分析的WordPress！无需技术设置。

Start the Installation 开始安装

If your web host offers one-click software (Softaculous or Installatron for example), you can 如果您的网络主机提供一键软件（例如Softaculous或Installatron），您可以 install Matomo in one click一键安装Matomo. Otherwise, follow these steps: 否则，请执行以下步骤：

1. Unzip the zip file to a folder on your hard drive. This will create a “matomo” folder containing the files and directories. 将zip文件解压缩到硬盘上的文件夹中。这将创建一个包含文件和目录的“matomo”文件夹。
2. Open your FTP client and upload the Matomo files in ‘binary mode’ to the desired location on your web server. For example using the Filezilla FTP client, you can enable Binary mode transfer in the top menu Transfer > Transfer type > Binary). All files can be uploaded to a “analytics” sub-directory in your public www folder, for example http://yourdomain.org/analytics/ or you could setup Matomo in its own subdomain and upload all the files at http://analytics.example.org/ 打开您的FTP客户端并以“二进制模式”将Matomo文件上传到您的Web服务器上的所需位置。例如，使用Filezilla FTP客户端，您可以在顶部菜单中启用二进制模式传输传输>传输类型>二进制）。所有文件都可以上传到您的公共www文件夹中的“analytics”子目录，例如http://yourdomain.org/analytics/，或者您可以在Matomo自己的子域中设置Matomo，然后将所有文件上传到http://analytics.example.org/

If you have SSH access to your server, you can use it instead of FTP as it is much faster: run如果您可以通过SSH访问服务器，则可以使用SSH而不是FTP，因为FTP要快得多：运行 wget https://builds.matomo.org/matomo.zip && unzip matomo.zip wgethttps://builds.matomo.org/matomo.zip&&解压缩matomo. zip

When Matomo is uploaded you can move on to the next step! Matomo上传后，您可以继续下一步！

The 5-minute Matomo Installation 5分钟的Matomo安装

Open your web browser and navigate to the URL to which you uploaded Matomo. If everything is uploaded correctly, you should see the Matomo Installation Welcome Screen. (If you are not seeing the Welcome screen, also check that your web server such as Apache or Nginx or IIS is configured and working). If there are any problems during the installation, Matomo will identify them and help you out with a solution. 打开您的Web浏览器并导航到您上载Matomo的URL。如果一切都上传正确，您应该看到Matomo安装欢迎屏幕。(If您没有看到欢迎屏幕，请检查您的Web服务器（如Apache或Nginx或IIS）是否已配置并正在运行）。如果在安装过程中出现任何问题，Matomo会找出问题并帮助您解决。

If there is a problem, Matomo will identify it and tell you how to solve it, as in this example: 如果出现问题，Matomo会识别它并告诉您如何解决它，如以下示例所示：

Matomo will check to make sure that your server meets the Matomo requirements. If everything is okay, you’ll see a long list like this: Matomo将检查以确保您的服务器满足Matomo要求。如果一切正常，您将看到一个很长的列表，如下所示：

System Check系统检查

Time to get started with the point-and-click installation! Click Next » 是时候开始点击安装了！点击 下一步

The Welcome Screen欢迎屏幕

When all the requirements are met, click Next » 满足所有要求后，单击“下一步”。

Enter the name and URL of the first website you want to track. You can add more websites once the installation is complete. 输入要跟踪的第一个网站的名称和URL。安装完成后，您可以添加更多网站。

Set up Your First Website设置您的第一个网站

Fill in the information and click Next » 填写信息并单击“下一步”

By default the super user will be signed up for upgrade and security alerts, as well as for community updates. Uncheck these boxes if you do not want to receive these emails. 默认情况下，超级用户将注册升级和安全警报，以及社区更新。如果您不想收到这些电子邮件，请取消选中这些复选框。

Do not lose this information; it is the only way for you to log in to Matomo for the first time. There is only one super user in each Matomo installation. The super user can perform administrative tasks such as adding new websites to monitor, adding users, changing user permissions, and enabling and disabling plugins. 不要丢失此信息;这是您第一次登录Matomo的唯一方法。每个Matomo安装中只有一个超级用户。超级用户可以执行管理任务，如添加要监视的新网站、添加用户、更改用户权限以及启用和禁用插件。

The super user is the user that you create when you install Matomo. This user has the highest permissions. Choose your username and password: 超级用户是安装Matomo时创建的用户。此用户具有最高权限。请输入用户名和密码：

Super User超级用户

Click Next » 点击 下一步

Matomo will add the necessary tables to your database: Matomo将在您的数据库中添加必要的表格：

Once you have filled in the form, click Next » 填写完表格后，单击“下一步”。

(Note that by default the port 3306 is used when connecting to the database. If your server uses a different port you can enter it after the hostname, for example localhost:3307) (Note连接到数据库时默认使用端口3306。如果您的服务器使用其他端口，则可以在主机名之后输入该端口，例如localhost：3307）

Security note: for added security, we recommend that you install Matomo in its own MySQL database and specify a username and password for a user that only has access to that database. Click here to see detailed instructions on how to create a new database and MySQL user. 安全说明：为了增加安全性，我们建议您在Matomo自己的MySQL数据库中安装Matomo，并为只能访问该数据库的用户指定用户名和密码。单击此处查看有关如何创建新数据库和MySQL用户的详细说明。

You should already have set up your MySQL database. If you do not have the database information, you may need to ask your web host or technical staff. 您应该已经设置了MySQL数据库。如果您没有数据库信息，您可能需要询问您的网站主机或技术人员。

MySQL Database SetupMySQL数据库设置

Click Next » 点击 下一步

Medium and High-Traffic Websites: Setup an automated task (cron) to process reports 中等流量和高流量网站：设置自动任务（cron）以处理报告

1. the matomo/tmp/ folder matomo /tmp/文件夹
2. the matomo/js/piwik.js and matomo/js/matomo.js files 该 matomo/js/piwik.js 以及 matomo/js/matomo.js档桉

When you have finished configuring Matomo, you can set more restrictive permissions (ie. read only) to the “matomo/config/” folder. There are only two places where Matomo will need to write files: 当您完成Matomo的配置后，您可以设置更严格的权限（即只读）到“matomo/config/”文件夹。Matomo只需要在两个地方写入文件：

If you want to give other users access to Matomo, or monitor more than one website, or rebrand Matomo or install third party plugins, you will need to use the Administration pages. Click “Administration” in the top menu, then click “Users” to manage users and permissions. 如果您想给予其他用户访问Matomo，或监控多个网站，或重新命名Matomo或安装第三方插件，您需要使用管理页面。单击顶部菜单中的“管理”，然后单击“用户”以管理用户和权限。

If the Matomo JavaScript tracking tag is properly installed on your website, you’ll be receiving real time analytics data. If you are not receiving any data, make sure that you have copied and pasted the Matomo Javascript code to your website’s pages. 如果Matomo JavaScript跟踪标签正确安装在您的网站上，您将收到真实的分析数据。如果您没有收到任何数据，请确保您已将Matomo Javascript代码复制并粘贴到您的网站页面。

Configuring Matomo 配置Matomo

If something isn’t working correctly or you are experiencing an error, you may want to take a look at the Troubleshooting Guide. 如果某些功能无法正常工作或遇到错误，您可能需要查看《故障排除指南》。

Click Continue to Matomo » and log in to your dashboard! 点击 Continue to Matomo并登录到您的仪表板！

Matomo is installed and ready to track your visitors. As soon as visitors start arriving, Matomo will be keeping track of their data. Matomo reports are generated in real time, so you should see data in your Matomo dashboard straight away. Matomo已安装并准备好跟踪您的访问者。一旦游客开始到达，Matomo将跟踪他们的数据。Matomo报告是真实的生成的，因此您可以立即在Matomo仪表板中看到数据。

Congratulations!恭喜你！

When you have copied your tracking tag click Next » 复制跟踪标签后，单击“下一步”。

Otherwise you will need to insert your tracking tag manually. 否则，您将需要手动插入跟踪标签。

Step-by-step guides are available for the most popular CMS such as: WordPress, Joomla, Webflow, Shopify store, SquareSpace, Wix, GoDaddy Website Builder, Drupal, Jimdo. Matomo can also be integrated in Android and iOS apps, in GTM (Google Tag Manager), Ionic mobile apps and more. 分步指南适用于最常用的CMS，例如： 文字出版社 ， 朱姆拉 ， 网络流 ， Shopify商店 ， 方形空间 ， 维克斯 ， 网站建设者 ， 德鲁帕尔 ，任都. Matomo还可以集成到 Android和iOS应用程序 ，在 GTM（谷歌标签管理器） ， Ionic移动的应用程序等等。

Matomo will issue you with a JavaScript tag. This code must appear on every page that you want Matomo to analyze. We recommend that you paste this code immediately before your closing </head> tag (or in a general header file that is included at the top of all your pages). Matomo将向您发送一个JavaScript标记。此代码必须出现在您希望Matomo分析的每个页面上。我们建议您将此代码粘贴在关闭</head>标记之前（或粘贴在所有页面顶部的通用头文件中）。

Install the JavaScript Tracking Tag安装JavaScript跟踪标记

If your website is a medium or high-traffic website (more than a few hundred visits per day), we highly recommend to set up auto-archiving cron task so that Matomo calculates your reports periodically. When the cron is setup and the timeout value increased, Matomo dashboard will load very quickly as the reports will be pre-processed by the core:archive command triggered by cron. 如果您的网站是一个中等或高流量的网站（每天访问量超过几百次），我们强烈建议您设置自动存档cron任务，以便Matomo定期计算您的报告。当cron设置好并且超时值增加时，Matomo仪表板将很快加载，因为报告将由cron触发的core：archive命令进行预处理。

If you do not setup the cron, Matomo will recalculate your statistics every time you visit a Matomo report, which will slow Matomo down and increase the load on your database. 如果您没有设置cron，Matomo将在您每次访问Matomo报告时重新计算您的统计数据，这将降低Matomo的速度并增加数据库的负载。

Instructions for setting up auto-archiving can be found on the Matomo website at How to setup Matomo auto-archiving. 有关设置自动存档的说明，请访问Matomo网站How to setup Matomo auto-archiving。

Updates, Recommended Server Configuration, and More 更新、建议的服务器配置等

Check also the Matomo Installation, Update & Optimization documentation for more information. 有关详细信息，请查看Matomo安装、更新&和优化文档。