InnoShop 安装比你想象的简单

很多人听到"开源系统"就觉得安装很复杂。其实 InnoShop 的安装过程已经做了大量优化，最快10 分钟就能跑起来。今天介绍三种安装方式，选择最适合你的。

方式一：Docker 一键部署（最推荐）

Docker 是最省心的方式，不需要配置 PHP、MySQL、Nginx，一条命令全部搞定。

前提条件

• 安装 Docker 和 Docker Compose
• 一台服务器（推荐 Ubuntu 22.04+）

安装步骤

# 1. 克隆 Docker 配置
git clone https://github.com/innoshop/docker.git innoshop
cd innoshop

# 2. 复制并编辑环境配置
cp .env.example .env
# 编辑 .env，设置域名和数据库密码

# 3. 启动容器
docker-compose up -d

# 4. 设置权限
docker-compose exec app chmod -R 755 storage bootstrap/cache

打开浏览器访问 http://你的域名，按安装向导操作即可。

整个过程 5 分钟搞定，包含 PHP-FPM、MySQL、Redis、Nginx 四个容器。

方式二：手动安装

适合喜欢自己控制每个组件版本的开发者。

环境要求

安装步骤

# 1. 克隆代码
git clone https://github.com/innoshop/innoshop.git
cd innoshop

# 2. 安装 PHP 依赖
composer install

# 3. 配置环境
cp .env.example .env
php artisan key:generate

# 4. 编辑 .env 配置数据库
vim .env
# 修改以下配置：
# DB_HOST=127.0.0.1
# DB_DATABASE=innoshop
# DB_USERNAME=root
# DB_PASSWORD=你的密码
# APP_URL=https://你的域名

# 5. 运行数据库迁移
php artisan migrate --seed

# 6. 设置文件权限
chmod -R 755 storage bootstrap/cache

# 7. 配置 Nginx 虚拟主机
# 将 root 指向 innoshop/public 目录

Nginx 配置参考

server {
    listen 80;
    server_name your-domain.com;
    root /var/www/innoshop/public;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/run/php/php8.3-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

方式三：宝塔面板安装

如果你用的是宝塔面板（国内很常见），安装更简单：

1. 在宝塔面板中创建网站，选择 PHP 8.2+
2. 进入网站目录，执行 git clone https://github.com/innoshop/innoshop.git .
3. 执行 composer install
4. 复制 .env.example 为 .env，配置数据库
5. 执行 php artisan key:generate
6. 执行 php artisan migrate --seed
7. 设置 storage 和 bootstrap/cache 目录权限为 755
8. 配置伪静态规则（选择 laravel5）
9. 访问网站完成安装向导

安装后必做的配置

1. 配置 SSL：使用 Let's Encrypt 免费证书，宝塔面板一键申请
2. 设置定时任务：* * * * * cd /path-to-innoshop && php artisan schedule:run >> /dev/null 2>&1
3. 配置队列（可选）：如果使用异步任务，配置 Supervisor 监听队列
4. 修改管理员密码：登录后台后第一时间修改默认密码
5. 配置缓存：确保 .env 中 CACHE_DRIVER=redis

常见问题排查

500 错误

最常见的原因：文件权限不对。执行 chmod -R 755 storage bootstrap/cache。

数据库连接失败

检查 .env 中的数据库配置是否正确，确认 MySQL 服务是否启动：systemctl status mysql。

页面空白

检查 PHP 扩展是否齐全。InnoShop 需要：openssl、pdo、mbstring、tokenizer、xml、ctype、json、bcmath、fileinfo。执行 php -m 查看已安装扩展。

Composer install 很慢

切换到国内镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

写在最后

安装只是第一步。装好之后，InnoShop 后台有完整的设置向导，引导你配置语言、货币、支付、物流。如果遇到问题，可以查阅官方文档或在社区提问。