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

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

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

• 连接服务器
  使用 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 面板是否有红色报错信息。
    
  
  

祝您安装顺利！如果在安装过程中遇到其他特定问题，建议查阅 icepos 项目的官方文档或在其社区寻求帮助。