【安装配置教程】ubuntu安装配置Kodbox

news2025/5/12 23:36:39

一、引言

二、环境配置

1. 服务器配置

2. 必备组件

三、安装基础环境

1. 安装 PHP 8.1 及扩展

2. 安装 MySQL 数据库

3.安装 Redis（可选，提升缓存性能）

4. 配置nginx文件

4.1. 创建 Kodbox 站点目录

4.2. 编写 Nginx 配置文件

4.3. 启用站点并测试

四、下载并安装 Kodbox

五、访问安装向导

一、引言

Kodbox（可道云）是一款功能强大的私有云存储与文件管理系统，支持多平台访问和丰富的扩展功能。本文将详细记录在 Ubuntu 服务器上安装配置 Kodbox 的完整过程，包括环境准备、组件安装、参数配置及常见问题解决，帮助读者快速搭建属于自己的私有云。

二、环境配置

1. 服务器配置

系统：Ubuntu 20.04/22.04 LTS（本文以 22.04 虚拟机部署为例）

硬件：4 核 CPU / 8GB 内存 / 100GB SSD

网络：公网 IP 地址，开放 80/443 端口（云服务器需配置安全组）

2. 必备组件

Web 服务器：Nginx 1.18+

PHP 环境：PHP 8.1（需安装 FPM 及相关扩展）

数据库：MySQL 8.0+ 或 MariaDB

缓存：Redis（可选，提升性能）

三、安装基础环境

1. 安装 PHP 8.1 及扩展

# 添加PHP官方源
sudo add-apt-repository ppa:ondrej/php
sudo apt update

# 安装PHP-FPM及必要扩展（含Redis、MySQL支持）
sudo apt install -y php8.1-fpm php8.1-cli php8.1-mysql php8.1-redis php8.1-gd php8.1-curl php8.1-zip php8.1-mbstring php8.1-bcmath php8.1-xml

2. 安装 MySQL 数据库

Ubuntu安装mysql数据库可以查看我之前写过的文章，直接配置好自己的root用户即可

【FISCO-BCOS】七、ubuntu安装并配置MySQL_mysql-server mysql-client libmysqlclient-dev-CSDN博客

3.安装 Redis（可选，提升缓存性能）

sudo apt install -y redis-server
sudo systemctl enable --now redis-server

4. 配置nginx文件

4.1. 创建 Kodbox 站点目录

sudo mkdir -p /var/www/kodbox
sudo chown -R www-data:www-data /var/www/kodbox  # 赋予Nginx用户权限
sudo chmod -R 777 /var/www/kodbox

4.2. 编写 Nginx 配置文件

vim /etc/nginx/conf.d/kodbox.conf

写入以下内容

server {
    listen 443;
    server_name 192.168.8.128;
    return 301 http://$host:60$request_uri;
}
server {
    listen 60;
    server_name 192.168.8.128;
    root /var/www/kodbox;
    index index.php index.html;

    error_log /var/log/nginx/kodbox.error.log;
    access_log /var/log/nginx/kodbox.access.log;

    location ^~ /static/ {
        root /var/www/kodbox;
        expires 30d;
        access_log off;
    }

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

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

        fastcgi_split_path_info ^(.+\.php)(/.+)$;
        fastcgi_param PATH_INFO $fastcgi_path_info;
        fastcgi_param HTTPS $scheme;

        fastcgi_buffer_size 128k;
        fastcgi_buffers 256 4k;
        fastcgi_busy_buffers_size 256k;
        fastcgi_temp_file_write_size 256k;
        fastcgi_read_timeout 300;
    }

    location ~ /(config|data|system)/.*\.(php|txt|bak|sh|inc|md|sql) {
        deny all;
    }

    client_max_body_size 2048M;
    client_body_buffer_size 128k;
}

4.3. 启用站点并测试

sudo nginx -t  # 检查配置语法
sudo systemctl restart nginx  # 重启Nginx

四、下载并安装 Kodbox

我推荐前往github直接拉取tar文件，地址如下kalcaddle/kodbox: kodbox is a file manager for web. It is a newly designed product based on kodexplorer. It is also a web code editor, which allows you to develop websites directly within the web browser.You can run kodbox either online or locally,on Linux, Windows or Mac based platformshttps://github.com/kalcaddle/kodbox/releases/tag/1.59.01 下载好之后上传到服务器，解压在/var/www/kodbox目录下，确保能直接定位到index.php。

五、访问安装向导

在浏览器输入ip地址+端口号，进入kodbox的安装界面

这个界面当然是不对的，因为我们没有做ssl证书配置，可以参考下面的博客进行ssl证书配置，当然，我们也可以在nginx配置文件中指定不使用https访问，不过这样处理欠妥，测试使用。

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

        fastcgi_split_path_info ^(.+\.php)(/.+)$;
        fastcgi_param PATH_INFO $fastcgi_path_info;
        fastcgi_param HTTPS off;    # 注意！主要修改此处为off

        fastcgi_buffer_size 128k;
        fastcgi_buffers 256 4k;
        fastcgi_busy_buffers_size 256k;
        fastcgi_temp_file_write_size 256k;
        fastcgi_read_timeout 300;
    }

现在回到安装页面，图片等样式就加载出来了