【01】针对开源收银系统icepos (宝塔面板) 详细安装教程详细参考-优雅草卓伊凡

引言

本文做参考，下篇文章直接实践，由于已经选型

本系统是服务端php开发的系统，他的系统环境如下：

系统安装

环境要求

ICEPOS对服务器或电脑硬件要求不高,可以使用单台电脑/自建服务器/云服务器

单台电脑，即可安装C#收银客户端+PHP服务端+管理后台。适合单独小卖部/中小型超市

自建服务器/云服务器适合多门店连锁+数据量访问大的中大型连锁超市

复制代码

  PHP >= 7.2 且 <= 7.4 (推荐PHP7.4版本)
  MySQL >= 5.6 且 <= 8.0 (需支持innodb引擎)
  Apache 或 Nginx

  // 客户端浏览器推荐
  Google Chrome v100+
  Firefox v100+
  Microsoft EDGE v100+
  Apple Safari v13+
  360浏览器 v14+ （极速模式）

icepos (宝塔面板) 详细安装教程

本教程假设您已经拥有一台安装了 纯净版 CentOS 7/8 或 Ubuntu 18/20 的云服务器或本地电脑，并已能够通过 SSH 连接。

第一部分：系统环境准备 (安装宝塔面板)

如果您的服务器尚未安装宝塔面板，请先执行此步骤。

连接服务器

使用 SSH 工具 (如 PuTTY, Terminal, Xshell) 连接到您的服务器。

安装宝塔面板

根据您的操作系统，执行对应的安装命令：

CentOS 系统安装命令：

复制代码

yum install -y wget && wget -O install.sh http://download.bt.cn/install/install_6.0.sh && sh install.sh

Ubuntu/Debian 系统安装命令：

复制代码

wget -O install.sh http://download.bt.cn/install/install-ubuntu_6.0.sh && sudo bash install.sh

完成安装

安装过程大约需要 1-5 分钟，完成后，命令行界面会显示宝塔面板的后台地址、用户名和密码。请务必妥善保存这些信息！

同时，您需要在云服务器的安全组/防火墙中放行面板端口（通常是 8888）。

第二部分：配置 icepos 所需环境

登录宝塔面板

在浏览器中打开上一步获取的宝塔面板地址，使用用户名和密码登录。
安装 Web 环境套件 (LNMP)

首次登录，宝塔会推荐您安装套件。请严格按照 icepos 的要求进行选择：
- Nginx 或 Apache： 任选其一，推荐 Nginx，性能更好。
- MySQL： 版本选择 5.6、5.7 或 8.0 (根据 icepos 文档推荐，建议选择 5.7，兼容性最好)。
- PHP： 版本必须选择 7.2、7.3 或 7.4 。本教程以 PHP-7.4 为例。
- 安装方式为"编译安装"或"极速安装"均可。
  点击【一键安装】后，等待宝塔自动完成安装，这个过程可能需要较长时间。
配置 PHP (关键步骤)
- 在宝塔面板首页，点击【软件商店】-> 找到已安装的 PHP-7.4，点击【设置】。
- 切换到【禁用函数】选项卡，找到并删除以下函数（icepos 安装可能需要）：
  putenv
  proc_open
  pcntl_signal
  pcntl_alarm
- 切换到【安装扩展】选项卡，确保以下扩展已安装：
  fileinfo
  exif
  opcache
  redis (如果计划使用 Redis 缓存，非必需但推荐)
- 点击【重载配置】或【重启PHP】使更改生效。

第三部分：部署 icepos 程序

添加网站
- 在宝塔面板首页，点击【网站】-> 【添加站点】。
- 域名： 如果您有域名，请填写（例如 pos.yourdomain.com）。如果还没有或仅在本地使用，可以填写您的服务器 IP 地址。
- 根目录： 默认即可，例如 /www/wwwroot/icepos。
- FTP 和数据库：
  - 勾选【创建数据库】，选择 MySQL，设置数据库名、用户名和密码。务必记录好这些信息，后续安装需要！
  - 勾选【创建FTP】可选，方便上传文件。
- PHP 版本： 务必选择您刚才安装的 PHP-7.4。
- 点击【提交】。
上传 icepos 程序文件

您需要从 icepos 的官方仓库（如 Gitee 或 GitHub）下载最新的发行版（Release）ZIP 压缩包。
- 方式一（推荐）： 在宝塔的【文件】管理中，进入您刚才创建的网站根目录（如 /www/wwwroot/icepos）。点击【上传】，将下载好的 icepos ZIP 压缩包上传至此，然后右键点击压缩包，选择【解压】。
- 方式二： 使用刚才创建的 FTP 账户，通过 FTP 客户端（如 FileZilla）将文件上传到网站根目录。
- 方式三（技术向）： 使用 SSH 命令，通过 wget 或 curl 直接下载到服务器目录，然后用 unzip 命令解压。
重要： 解压后，确保网站根目录直接包含 index.php、app、public 等文件，而不是多一层文件夹。如果有多余文件夹，请将内部所有文件移动到网站根目录。
设置目录权限

在宝塔的【文件】管理中，进入网站根目录，选中以下目录，点击上方的【权限】按钮，将其权限设置为 755，并勾选【应用到子目录】。
- storage/
- bootstrap/cache/
  如果无法写入，可能需要将这些目录的所有者改为 www 用户。

第四部分：安装 icepos

开始安装向导

打开浏览器，访问您为 icepos 设置的域名或服务器IP地址（例如 http://your-server-ip）。

如果一切配置正确，您应该会看到 icepos 的安装向导界面。
环境检测

安装程序会自动检查环境是否符合要求。如果前面步骤都正确，这里应该全是绿色的对勾（√）。点击【下一步】。
数据库配置

填写您在创建网站时记录的数据库信息：
- 数据库地址： 默认是 localhost 或 127.0.0.1（如果数据库和网站在同一服务器）。
- 数据库名： 填写您创建的数据库名称。
- 用户名： 填写该数据库的用户名。
- 密码： 填写该数据库的密码。
- 表前缀： 默认即可（如 ice_），除非您有特殊需求。
  点击【测试连接】，成功后再点击【下一步】。
创建管理员账户

设置您的超级管理员账号信息：
- 用户名、邮箱、密码等。
  请务必使用强密码并牢记。
完成安装

点击【安装】，系统会自动导入数据库结构和初始数据。安装完成后，通常会提示您"安装成功"。
出于安全考虑，安装程序会强烈建议您删除安装目录（通常是 /install 文件夹）。 请务必通过宝塔【文件】管理找到并删除它。

第五部分：登录与验证

访问后台

安装完成后，点击【进入后台】或访问 http://your-domain.com/admin，使用您刚才创建的管理员账号登录。
访问前台 (收银端)

收银端通常位于 http://your-domain.com 或有一个单独的入口，您可以在后台的系统设置中找到准确的URL。
后续配置

登录管理后台后，您需要进一步配置：
- 系统设置： 设置门店名称、地址、电话、税率等。
- 支付方式： 配置现金、刷卡、支付宝、微信支付等。
- 商品管理： 添加商品、分类、库存。
- 员工管理： 为收银员创建账号并分配权限。

常见问题排查 (Q&A)

Q: 访问网站显示 500 错误？
- A: 通常是目录权限或 PHP 扩展问题。请返回检查 storage/ 和 bootstrap/cache/ 目录权限是否为 755（或 777），并检查 PHP 的 fileinfo 扩展是否安装。
Q: 安装向导无法连接数据库？
- A: 1. 检查数据库地址、名、用户名、密码是否正确。2. 检查数据库是否正在运行（在宝塔【软件商店】查看MySQL状态）。3. 检查服务器防火墙/安全组是否放行了 3306 端口（本地安装通常无需此操作）。
Q: 页面排版错乱，CSS/JS 加载不了？
- A: 在宝塔的【网站】设置中，找到对应网站，点击【设置】->【网站目录】，确认【运行目录】一项是否正确设置为 public（对于 Laravel 框架的程序通常如此，请以 icepos 官方文档为准）。
Q: 收银端无法打开或白屏？
- A: 确保您使用的浏览器版本符合要求（Chrome/Edge 100+），并尝试按 F12 打开开发者工具，查看 Console 面板是否有红色报错信息。