如何在本地部署 Puter 云桌面系统，图文教程

1、Puter 是什么？

        Puter 不是普通的云存储工具，而是一个完整的网络操作系统。Puter旨在提供异常快速且高度可扩展的操作系统体验。它可以在浏览器中运行，无需安装额外的软件，为用户提供一个全新的Web端桌面体验环境。作为一个开源项目，Puter的源代码是公开的，并且可以在GitHub等平台上找到。

2、部署 Puter

2.1、方法1：使用 Node.js

2.1.1、环境准备

        确保你的电脑上安装了 Node.js（版本 16+）和 npm。

     

2.1.2、安装puter

                1、克隆 Puter 的仓库

git clone https://github.com/HeyPuter/puter.git

                2、进入项目目录并安装依赖

cd puter
npm install

              3、启动 Puter

npm start

        4、访问puter云桌面

        启动完成后，会弹出一个浏览器窗口，如下图：

        看到这个页面，说明puter云桌面已经安装完成，可以使用了。

2.2、方法2：Docker部署

如果你喜欢用 Docker，这里有两个选择：

2.2.1、环境准备

        docker安装：安装教程

2.2.1、第一种方式：基于 Docker 启动 Puter 服务

       mkdir -p /opt/puter/data  /opt/puter/config 

docker run -d \
--name puter \
--restart unless-stopped \
--network bridge \
-p 4100:4100 \
-e TZ=Asia/Shanghai \
-e CONFIG_PATH=/etc/puter \
-e PUID=1000 \
-e PGID=1000 \
-v ./opt/puter/config:/etc/puter \
-v ./opt/puter/data:/var/puter \
ghcr.io/heyputer/puter:latest

2.2.2、第二种方式：基于 Docker-Compose 启动 Puter 服务

       1、 创建puter目录，如下：

mkdir -p /opt/puter/data  /opt/puter/config 

cd /opt/puter

vi docker-compose.yml

      2、 进入/opt/puter/目录下，创建一个docker-compose.yml文件，内容如下：

services:
  puter:
    container_name: puter
    image: ghcr.io/heyputer/puter:latest
    pull_policy: always
    restart: unless-stopped
    network_mode: bridge
    ports:
      - '4100:4100'
    environment:
      TZ: Asia/Shanghai
      CONFIG_PATH: /etc/puter
      PUID: 1000
      PGID: 1000
    volumes:
      - ./opt/puter/config:/etc/puter
      - ./opt/puter/data:/var/puter

        3、进入/opt/puter/目录下运行

docker-compose up -d

部署完成后，你就可以通过访问http://ip:4100来使用 Puter 了。