Mikochi + Docker：打造属于你的私有云文件浏览器

一、Mikochi介绍
二、本地环境介绍
- [2.1 本地环境规划](#2.1 本地环境规划)
- [2.2 本次实践介绍](#2.2 本次实践介绍)
三、本地环境检查
- [3.1 检查Docker服务状态](#3.1 检查Docker服务状态)
- [3.2 检查Docker版本](#3.2 检查Docker版本)
- [3.3 检查docker compose 版本](#3.3 检查docker compose 版本)
四、下载Mikochi镜像
五、部署Mikochi工具
- [5.1 创建挂载目录](#5.1 创建挂载目录)
- [5.2 docker-cli创建Mikochi容器](#5.2 docker-cli创建Mikochi容器)
- [5.3 编辑docker-compose.yaml文件](#5.3 编辑docker-compose.yaml文件)
- [5.4 创建Mikochi容器](#5.4 创建Mikochi容器)
- [5.5 检查Mikochi容器状态](#5.5 检查Mikochi容器状态)
- [5.6 检查Mikochi容器日志](#5.6 检查Mikochi容器日志)
六、Mikochi的基本使用
- [6.1 访问Mikochi首页](#6.1 访问Mikochi首页)
- [6.2 上传文件](#6.2 上传文件)
- [6.3 分享文件](#6.3 分享文件)
- [6.4 上传视频文件](#6.4 上传视频文件)
七、总结

一、Mikochi介绍

Mikochi是一个远程文件浏览器，适用于自托管服务器和NAS。它提供了许多功能，包括浏览远程文件夹、上传、删除、重命名文件，以及将文件流式传输到VLC/mpv。Mikochi使用JavaScript和Preact创建了一个易于使用的Web界面，并通过Go和Gin构建了一个强大的API。这些功能被不断优化以提供更好的性能和用户体验。

二、本地环境介绍

2.1 本地环境规划

本次实践为个人测试环境，操作系统版本为centos7.6。

hostname	IP地址	操作系统版本	Docker版本
jeven	192.168.3.166	centos 7.6	20.10.17

2.2 本次实践介绍

1.本次实践部署环境为个人测试环境，生产环境请谨慎；

2.在Docker环境下部署Mikochi文件管理工具。

三、本地环境检查

3.1 检查Docker服务状态

检查Docker服务是否正常运行，确保Docker正常运行。

bash 复制代码

[root@jeven ~]# systemctl status docker
● docker.service - Docker Application Container Engine
   Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; vendor preset: disabled)
   Active: active (running) since Tue 2023-12-19 13:51:24 CST; 2 days ago
     Docs: https://docs.docker.com
 Main PID: 11579 (dockerd)
    Tasks: 48
   Memory: 902.0M
   CGroup: /system.slice/docker.service

3.2 检查Docker版本

检查Docker版本

bash 复制代码

[root@jeven ~]# docker -v
Docker version 20.10.17, build 100c701

3.3 检查docker compose 版本

检查Docker compose版本，确保2.0以上版本。

bash 复制代码

[[root@jeven ~]# docker compose version
Docker Compose version v2.19.1

四、下载Mikochi镜像

在docker hub下载Mikochi镜像，镜像版本为latest。如果cpu架构为arm/v7的设备，可以使用镜像标签为latest-armv7或者 1.3.1-armv7 。

bash 复制代码

[root@jeven ~]# docker pull zer0tonin/mikochi:latest
latest: Pulling from zer0tonin/mikochi
aece8493d397: Pull complete
b0068834b9c4: Pull complete
3baeb5baef9f: Pull complete
f1b3574193ea: Pull complete
Digest: sha256:42d9ac3db179bda9531023406c397a342feb02a50b44623e8a1f497abe5da946
Status: Downloaded newer image for zer0tonin/mikochi:latest
docker.io/zer0tonin/mikochi:latest

五、部署Mikochi工具

5.1 创建挂载目录

创建挂载目录/data/mikochi/data

bash 复制代码

mkdir -p /data/mikochi/data && cd /data/mikochi

5.2 docker-cli创建Mikochi容器

docker-cli创建mikochi容器，访问账号和密码可自定义设置。

bash 复制代码

docker run -d \
--restart always \
-p 8080:8080  \
-v /data/mikochi/data:/data \
-e DATA_DIR="/data"  \
-e USERNAME=admin \ 
-e PASSWORD=admin  \
 zer0tonin/mikochi:latest

环境变量解释：

HOST ：ip:port 方式，例如0.0.0.0:80。
DATA_DIR： mikochi/DATA访问的目录
JWT_SECRET：用于JWT验证的秘密字符串 $随机$
USERNAME：使用设置的用户名登录 mikochi
PASSWORD：使用设置的密码登录 mikochi

5.3 编辑docker-compose.yaml文件

编辑docker-compose.yaml部署文件，本次实践使用docker compose方式创建mikochi容器。

yaml 复制代码

version: '3'

services:
  mikochi:
    image: zer0tonin/mikochi:latest
    restart: always
    ports:
      - 8080:8080
    volumes:
      - /data/mikochi/data:/data
    environment:
      - DATA_DIR=/data
      - USERNAME=admin
      - PASSWORD=admin

5.4 创建Mikochi容器

使用docker compose创建mikochi容器

bash 复制代码

[root@jeven mikochi]# docker compose up -d
[+] Running 2/2
 ⠿ Network mikochi_default      Created                                                                                 0.1s
 ⠿ Container mikochi-mikochi-1  Started                                                                                 0.7s

5.5 检查Mikochi容器状态

检查mikochi容器状态，确保mikochi容器正常启动。

bash 复制代码

[root@jeven mikochi]# docker compose ps
NAME                COMMAND             SERVICE             STATUS              PORTS
mikochi-mikochi-1   "./mikochi"         mikochi             running             0.0.0.0:8080->8080/tcp, :::8080->8080/tcp

5.6 检查Mikochi容器日志

检查mikochi容器运行日志，确保mikochi服务正常运行。

bash 复制代码

[root@jeven mikochi]# docker compose logs
mikochi-mikochi-1  | 2023/12/21 09:29:56 Caching /data
mikochi-mikochi-1  | 2023/12/21 09:29:57 Refreshed cached
mikochi-mikochi-1  | 2023/12/21 09:29:57 Listening on 0.0.0.0:8080