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

【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 连接。

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

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

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

2. 安装宝塔面板
   根据您的操作系统，执行对应的安装命令：

   • 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
     

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

   

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

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

1. 登录宝塔面板
   在浏览器中打开上一步获取的宝塔面板地址，使用用户名和密码登录。

2. 安装 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 为例。
   • 安装方式为“编译安装”或“极速安装”均可。
     点击【一键安装】后，等待宝塔自动完成安装，这个过程可能需要较长时间。

3. 配置 PHP (关键步骤)

   • 在宝塔面板首页，点击【软件商店】-> 找到已安装的 PHP-7.4，点击【设置】。
   • 切换到【禁用函数】选项卡，找到并删除以下函数（icepos 安装可能需要）：
     putenv
proc_open
pcntl_signal
pcntl_alarm
   • 切换到【安装扩展】选项卡，确保以下扩展已安装：
     fileinfo
exif
opcache
redis (如果计划使用 Redis 缓存，非必需但推荐)
   • 点击【重载配置】或【重启PHP】使更改生效。

第三部分：部署 icepos 程序

1. 添加网站

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

2. 上传 icepos 程序文件
   您需要从 icepos 的官方仓库（如 Gitee 或 GitHub）下载最新的发行版（Release）ZIP 压缩包。

   • 方式一（推荐）： 在宝塔的【文件】管理中，进入您刚才创建的网站根目录（如 /www/wwwroot/icepos）。点击【上传】，将下载好的 icepos ZIP 压缩包上传至此，然后右键点击压缩包，选择【解压】。
   • 方式二： 使用刚才创建的 FTP 账户，通过 FTP 客户端（如 FileZilla）将文件上传到网站根目录。
   • 方式三（技术向）： 使用 SSH 命令，通过 wget 或 curl 直接下载到服务器目录，然后用 unzip 命令解压。

   重要： 解压后，确保网站根目录直接包含 index.php、app、public 等文件，而不是多一层文件夹。如果有多余文件夹，请将内部所有文件移动到网站根目录。

3. 设置目录权限
   在宝塔的【文件】管理中，进入网站根目录，选中以下目录，点击上方的【权限】按钮，将其权限设置为 755，并勾选【应用到子目录】。

   • storage/
   • bootstrap/cache/
     如果无法写入，可能需要将这些目录的所有者改为 www 用户。

第四部分：安装 icepos

1. 开始安装向导
   打开浏览器，访问您为 icepos 设置的域名或服务器IP地址（例如 http://your-server-ip）。
   如果一切配置正确，您应该会看到 icepos 的安装向导界面。

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

3. 数据库配置
   填写您在创建网站时记录的数据库信息：

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

4. 创建管理员账户
   设置您的超级管理员账号信息：

   • 用户名、邮箱、密码等。
     请务必使用强密码并牢记。

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

第五部分：登录与验证

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

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

3. 后续配置
   登录管理后台后，您需要进一步配置：

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

常见问题排查 (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 面板是否有红色报错信息。