菜单

Puter开源互联网操作系统

全文摘要
Puter 是一个开源的互联网操作系统，旨在提供隐私保护、快速且高度可扩展的个人云服务。它支持多平台，包括 Linux、macOS 和 Windows，具有丰富的功能，如文件存储、网站构建、远程桌面等。Puter 提供本地开发、Docker 和 Docker Compose 的部署方式，并有详细的自托管指南。社区活跃，支持多种语言，并在 GitHub 上开源，遵循 AGPL-3.0 许可证。

关键段落
– 项目简介
– Puter 是一个先进的、开源的互联网操作系统，设计目标是功能丰富、速度极快且高度可扩展。它可以用作隐私优先的个人云，用于存储文件、应用和游戏；也可以作为构建和发布网站、Web 应用和游戏的平台；还是 Dropbox、Google Drive、OneDrive 等的替代品，具有全新的界面和强大的功能；此外，它也能作为服务器和工作站的远程桌面环境。
– 开始使用
– 本地开发：通过 Git 克隆项目，安装 npm 依赖后启动，即可在本地访问 Puter。
– Docker：创建目录并设置权限后，使用 Docker 命令运行 Puter 容器。
– Docker Compose：在 Linux/macOS 上创建目录、设置权限并下载 docker-compose.yml 文件后，使用 docker compose up 启动；在 Windows 上创建目录并使用 PowerShell 下载 docker-compose.yml 文件后，同样使用 docker compose up 启动。
– 系统要求
– 支持的操作系统包括 Linux、macOS 和 Windows；最低需要 2GB 内存（推荐 4GB），1GB 磁盘空间；需要 Node.js 16+（推荐 23+）和最新稳定版本的 npm。
– 支持与社区
– 用户可以通过 GitHub 提交问题、加入 Discord 社区、关注 X（Twitter）、Reddit 社区或 Mastodon 账号与维护者和社区成员交流。对于安全问题，可以联系 [email protected]，也可以通过 [email protected] 联系维护者。

本地部署Puter的流程主要包括以下步骤：

1. 克隆项目

  • 打开终端或命令提示符。
  • 使用以下命令克隆Puter的GitHub仓库：

    “`bash
    git clone https://github.com/HeyPuter/puter.git
    “`

  • 进入项目目录：

    “`bash
    cd puter
    “`

2. 安装依赖

  • 确保你的系统已安装Node.js（版本16+，推荐23+）和npm（最新稳定版本）。
  • 在项目目录中运行以下命令以安装所有依赖项：

    “`bash
    npm install
    “`

3. 配置环境变量（可选）

  • 如果需要自定义配置，可以创建一个.env文件。例如：

    “`plaintext
    PORT=3000
    “`

  • 默认情况下，Puter会运行在端口3000上。

4. 启动Puter

  • 在项目目录中运行以下命令启动Puter：

    “`bash
    npm start
    “`

  • 如果一切正常，Puter将在本地运行，通常可以通过访问http://localhost:3000来访问。

5. 访问Puter

  • 打开浏览器，访问http://localhost:3000。
  • 如果是首次运行，Puter可能会提示你进行一些初始设置，例如创建用户账户或配置存储路径。

6. （可选）配置HTTPS

  • 如果需要在本地使用HTTPS，可以生成自签名证书或使用有效的SSL证书。
  • 将证书文件（如cert.pem和key.pem）放置在项目目录下，并在.env文件中配置：

    “`plaintext
    HTTPS=true
    SSL_CERT=cert.pem
    SSL_KEY=key.pem
    “`

7. （可选）使用Docker部署

  • 如果你更喜欢使用Docker，也可以按照以下步骤进行部署：
    1. 安装Docker：确保你的系统已安装Docker。
    2. 创建Docker目录：在任意位置创建一个目录，例如puter-data，并设置权限： 
      mkdir puter-data
chmod -R 777 puter-data
    3. 运行Docker容器： 
      docker run -d --name puter -p 3000:3000 -v $(pwd)/puter-data:/puter/data heyputer/puter
    4. 访问Puter：通过http://localhost:3000访问。

注意事项

  • 如果在部署过程中遇到问题，可以查看Puter的官方文档或在GitHub的Issues中寻求帮助。
  • 如果需要更高级的配置，例如自定义存储路径、启用多用户模式等，可以参考Puter的配置文档。

希望这些步骤能帮助你成功部署Puter！

以下是基于搜索结果整理的在Windows 10上通过Docker Desktop部署Puter的流程：

一、安装Docker Desktop

  1. 检查系统要求
    • 确保Windows 10是64位的专业版、企业版或教育版，版本号需为1909或更高[^2^]。
    • 硬件需支持虚拟化，并在BIOS中启用[^5^]。
    • 系统至少需要4GB内存（推荐8GB或更多），以及足够的磁盘空间[^2^]。
  2. 下载Docker Desktop
    • 访问Docker官网，下载Docker Desktop for Windows[^2^][^3^]。
  3. 运行安装程序
    • 双击下载的Docker Desktop Installer.exe文件启动安装向导[^2^][^3^]。
    • 在配置页面中，建议选择“使用WSL 2而不是Hyper-V”（推荐）[^3^]。
    • 按照安装向导的提示完成安装，可能需要重启计算机[^2^][^3^]。
  4. 添加用户到docker-users组（如果需要）
    • 如果你的管理员账户和用户账户不同，需要将用户账户添加到docker-users组[^1^]。
      • 以管理员身份运行“计算机管理”。
      • 导航到“本地用户和组” > “组” > “docker-users”。
      • 右键单击以添加用户到该组。
      • 注销并重新登录以使更改生效[^1^]。

二、安装WSL 2（如果尚未安装）

  1. 安装WSL 2
    • 打开PowerShell（以管理员身份），运行以下命令： 
      wsl --install
    • 安装完成后，重启计算机[^5^]。

三、下载并运行Puter的Docker容器

  1. 拉取Puter的Docker镜像
    • 打开命令提示符或PowerShell，运行以下命令： 
      docker pull heyputer/puter
  2. 运行Puter容器
    • 创建一个目录用于存储Puter的数据，例如puter-data，并设置权限[^1^]： 
      mkdir puter-data
chmod -R 777 puter-data
    • 使用以下命令运行Puter容器： 
      docker run -d --name puter -p 3000:3000 -v $(pwd)/puter-data:/puter/data heyputer/puter
      • -d表示后台运行容器。
      • --name puter为容器命名为puter。
      • -p 3000:3000将容器的3000端口映射到主机的3000端口。
      • -v $(pwd)/puter-data:/puter/data将本地的puter-data目录挂载到容器内的/puter/data目录，用于持久化存储[^1^]。
  3. 访问Puter
    • 打开浏览器，访问http://localhost:3000，即可使用Puter[^1^]。

四、验证Docker安装

  1. 检查Docker版本
    • 打开命令提示符或PowerShell，运行以下命令： 
      docker --version
    • 如果安装成功，将显示Docker的版本信息[^5^]。
  2. 运行Hello World容器
    • 运行以下命令： 
      docker run hello-world
    • 如果Docker正常工作，将显示欢迎信息[^5^]。

五、（可选）配置HTTPS

  1. 生成自签名证书
    • 可以使用OpenSSL生成自签名证书，例如： 
      openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365
  2. 配置Puter使用HTTPS
    • 将生成的cert.pem和key.pem文件放置在puter-data目录下[^1^]。
    • 创建一个.env文件（如果尚未创建），并添加以下内容： 
      HTTPS=true
SSL_CERT=cert.pem
SSL_KEY=key.pem
    • 重新启动Puter容器： 
      docker restart puter
    • 访问https://localhost:3000，浏览器可能会提示证书不受信任，但可以继续访问[^1^]。

六、（可选）其他配置

  • 配置环境变量
    • 如果需要自定义Puter的配置，可以在puter-data目录下创建一个.env文件，并添加所需的环境变量[^1^]。
  • 持久化存储
    • 确保将重要的数据存储在挂载的puter-data目录中，以便在容器重启后能够保留数据[^1^]。

通过以上步骤，你可以在Windows 10上通过Docker Desktop成功部署Puter，并根据需要进行进一步的配置。

相关文章