ubuntu部署kodcloud网盘系统

Posted on Views:

一、环境准备

系统要求：

  • Ubuntu 20.04 LTS
  • 内存 ≥ 1GB
  • 网络可访问公网（下载依赖）

二、安装基础依赖

1
2
sudo apt update
sudo apt install -y apache2 php php-cli php-mbstring php-zip php-gd php-curl php-xml php-json php-mysql unzip wget

💡 KodCloud 需要 PHP ≥ 7.2，Ubuntu 20.04 默认是 PHP 7.4，刚好兼容。
可选扩展（推荐安装）：

1
sudo apt install -y php-fileinfo php-intl php-exif php-bcmath php-ldap

三、下载 kodcloud 开源版

1
2
3
4
5
cd /var/www/html
sudo wget https://static.kodcloud.com/update/download/kodexplorer4.51.zip -O kodcloud.zip
sudo unzip kodcloud.zip -d kodcloud
sudo chown -R www-data:www-data kodcloud
sudo chmod -R 755 kodcloud

最新版本可在官网查阅：
https://kodcloud.com/download/

四、配置 Apache 虚拟主机

创建配置文件：

1
sudo nano /etc/apache2/sites-available/kodcloud.conf

内容如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
<VirtualHost *:80>
    ServerAdmin admin@local
    DocumentRoot /var/www/html/kodcloud
    ServerName kodcloud.local

    <Directory /var/www/html/kodcloud>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/kodcloud_error.log
    CustomLog ${APACHE_LOG_DIR}/kodcloud_access.log combined
</VirtualHost>

启用站点和模块：

1
2
3
sudo a2ensite kodcloud.conf
sudo a2enmod rewrite
sudo systemctl restart apache2

五、设置 hosts（如果是本地测试）

1
sudo bash -c 'echo "127.0.0.1 kodcloud.local" >> /etc/hosts'

六、浏览器访问验证

访问：

http://kodcloud.local

你将看到 KodCloud 初始化安装界面。

按照提示完成：

  1. 选择语言（默认中文）
  2. 检查 PHP 环境（如果显示绿勾说明都正常）
  3. 设置管理员账号和密码
  4. 设置存储目录（建议默认 /var/www/html/kodcloud/data）

安装完成后进入主界面，即为部署成功。

七、权限与安全建议

  1. 目录权限：

    1
    2
    sudo chown -R www-data:www-data /var/www/html/kodcloud
    sudo chmod -R 750 /var/www/html/kodcloud

  2. 禁止外部访问安装文件：

    1
    rm -rf /var/www/html/kodcloud/data/install.lock

  3. 开启 HTTPS（可选）：

    1
    2
    sudo apt install -y certbot python3-certbot-apache
    sudo certbot --apache -d kodcloud.local

八、快速验证命令行版 PHP 运行是否正常

1
2
cd /var/www/html/kodcloud
sudo -u www-data php index.php

若无错误输出，说明 PHP 环境正常。

九、docker-compose 快速部署（可选）

如果你偏好容器化，可以直接使用官方镜像：

1
2
3
4
5
6
7
8
9
10
version: "3"
services:
  kodcloud:
    image: kodcloud/kodbox
    container_name: kodcloud
    ports:
      - "8080:80"
    volumes:
      - ./data:/var/www/html
    restart: always

启动：

1
docker-compose up -d

访问：

http://localhost:8080

01de30c2beb937089e05ea2242035a9b.png