diff --git a/docs/.vitepress/en.ts b/docs/.vitepress/en.ts index b60eeddef..635bf14c1 100644 --- a/docs/.vitepress/en.ts +++ b/docs/.vitepress/en.ts @@ -94,9 +94,10 @@ const side = { text: "Using ISO image", link: "/manual/get-started/install-pve-iso", }, + { text: "LXC on PVE", link: "/manual/get-started/install-lxc" }, ], }, - { text: "LXC", link: "/manual/get-started/install-lxc" }, + { text: "Raspberry Pi", link: "/manual/get-started/install-raspberry-pi", @@ -593,58 +594,6 @@ const side = { text: "Olares versioning", link: "/developer/install/versioning", }, - { - text: "Additional installations", - link: "/developer/install/additional-installations", - collapsed: true, - items: [ - { text: "Linux (via Docker)", link: "/developer/install/linux-via-docker-compose"}, - { - text: "macOS", - collapsed: true, - items: [ - { - text: "Using the script (recommended)", - link: "/developer/install/mac", - }, - { - text: "Using Docker image", - link: "/developer/install/mac-via-docker-image", - }, - ], - }, - { - text: "Windows (WSL 2)", - collapsed: true, - items: [ - { - text: "Using the script (recommended)", - link: "/developer/install/windows", - }, - { - text: "Using Docker image", - link: "/developer/install/windows-via-docker-image", - }, - ], - }, - { - text: "PVE", - collapsed: true, - items: [ - { - text: "Using the script (recommended)", - link: "/developer/install/pve", - }, - { - text: "Using ISO image", - link: "/developer/install/pve-via-iso-image", - }, - ], - }, - { text: "LXC", link: "/developer/install/lxc" }, - { text: "Raspberry Pi", link: "/developer/install/raspberry-pi" }, - ], - }, ], }, { diff --git a/docs/.vitepress/zh.ts b/docs/.vitepress/zh.ts index 2b8d9a49b..c0aea73a1 100644 --- a/docs/.vitepress/zh.ts +++ b/docs/.vitepress/zh.ts @@ -96,8 +96,9 @@ const side = { text: "使用 ISO 镜像", link: "/zh/manual/get-started/install-pve-iso", }, + { text: "LXC", link: "/zh/manual/get-started/install-lxc" }, ], - },{ text: "LXC", link: "/zh/manual/get-started/install-lxc" }, + }, { text: "树莓派", link: "/zh/manual/get-started/install-raspberry-pi", diff --git a/docs/manual/get-started/install-linux-iso.md b/docs/manual/get-started/install-linux-iso.md index 4e94807ae..4ac96e4be 100644 --- a/docs/manual/get-started/install-linux-iso.md +++ b/docs/manual/get-started/install-linux-iso.md @@ -11,7 +11,7 @@ This guide explains how to install Olares on a physical machine using the offici ## Prerequisites - **Host requirements**: - - **CPU**: 4 cores or more. + - **CPU**: Minimum 4 cores with **x86-64 architecture** (Intel or AMD). ARM-based processors are not currently supported for this method. - **Memory**: At least 8 GB of available RAM. - **Storage**: Minimum 150 GB SSD. - **Network**: The device must be connected to a wired LAN. @@ -23,7 +23,7 @@ This guide explains how to install Olares on a physical machine using the offici ## Create a bootable USB drive -1. Click [here](https://cdn.olares.com/) to download the official Olares ISO image. +1. Click [here](https://cdn.olares.com/olares-latest-amd64.iso) to download the official Olares ISO image. 2. Download and install [**Balena Etcher**](https://etcher.balena.io/). 3. Insert the USB flash drive into your computer. 4. Launch Etcher and follow these steps: diff --git a/docs/manual/get-started/install-olares.md b/docs/manual/get-started/install-olares.md index caa315331..475d177c8 100644 --- a/docs/manual/get-started/install-olares.md +++ b/docs/manual/get-started/install-olares.md @@ -19,10 +19,8 @@ Olares supports multiple platforms and deployment methods. Choose the installati Linux (Ubuntu or Debian) is the recommended platform for running Olares, as it offers the best performance and stability in production environments. -| Method | Description | -|------------------------------------------------------|--------------| -| [**Using ISO image**](install-linux-iso.md) | Fresh ISO install on a physical machine, automatically configuring the
host (Linux) environment, container runtime, drivers, and core
dependencies. | -| [**Using one-line script**](install-linux-script.md) | Quick install on existing Linux systems. | +- [**ISO image**](install-linux-iso.md): Perform a fresh installation on a physical machine, auto
configuring the Linux host environment, container runtime,
drivers, and core dependencies. | +- [**One-line script**](install-linux-script.md): Quick install on existing Linux systems. :::tip Recommendation The ISO installation method ensures maximum compatibility, performance, and system-level optimization. @@ -32,34 +30,18 @@ The ISO installation method ensures maximum compatibility, performance, and syst These methods are suitable for **development**, **testing**, or **lightweight environments**. -#### Linux - -- [**Using Docker Compose**](install-linux-docker.md): Runs Olares in a containerized environment using Docker Compose in Linux. - - #### Windows - -| Method | Description | -|--------------------------------------------------------|----------------------------------------------------------| -| [**Using one-line script**](install-windows-script.md) | Installs Olares in Windows Subsystem for Linux 2 (WSL 2). | -| [**Using Docker image**](install-windows-docker.md) | Runs Olares in Docker container with WSL 2 integration. | +- [**One-line script**](install-windows-script.md): Install Olares in Windows Subsystem for Linux 2 (WSL 2). +- [**Docker image**](install-windows-docker.md): Run Olares in Docker with WSL 2 integration. #### macOS - -| Method | Description | -|------------------------------------------------|-----------------------------------------------------------------| -| [**Using one-line script**](install-mac-script.md) | Installs Olares within a containerized environment via MiniKube. | -| [**Using Docker image**](install-mac-docker.md) | Runs Olares in Docker on macOS. | ---- +- [**One-line script**](install-mac-script.md): Install Olares in a containerized environment via MiniKube. +- [**Docker image**](install-mac-docker.md): Run Olares in Docker on macOS. #### PVE +- [**ISO image (recommended)**](install-pve-iso.md): Deploy Olares as a full VM in Proxmox VE using the ISO installer. +- [**One-line script**](install-pve-script.md): Install Olares directly on a PVE node. +- [**LXC container**](install-lxc.md): Deploy Olares in Proxmox VE using Linux containers (LXC). -| Method | Description | -|-------------------------------------------------|--------------| -| [**Using ISO image**](install-pve-iso.md) | Deploys Olares as a full VM in Proxmox using the ISO installer. | -| [**Using one-line script**](install-pve-script.md) | Installs Olares directly on a PVE node. | - - #### Raspberry Pi (ARM) - -- [**Using one-line script**](install-raspberry-pi.md): Installs Olares on ARM-based Raspberry Pi boards. - +#### Raspberry Pi (ARM) +- [**One-line script**](install-raspberry-pi.md): Install Olares on ARM-based Raspberry Pi devices. diff --git a/docs/manual/get-started/install-pve-iso.md b/docs/manual/get-started/install-pve-iso.md index 0203be334..7ade19e21 100644 --- a/docs/manual/get-started/install-pve-iso.md +++ b/docs/manual/get-started/install-pve-iso.md @@ -13,13 +13,13 @@ Currently, Olares on PVE has certain limitations. We recommend using it only for ## System requirements Make sure your device meets the following requirements. -- CPU: At least 4 cores + **CPU**: Minimum 4 cores with **x86-64 architecture** (Intel or AMD). ARM-based processors are not currently supported for this method. - RAM: At least 8GB of available memory - Storage: At least 200GB of available SSD storage. The installation will likely fail if an HDD (mechanical hard drive) is used instead of an SSD. - Supported Systems: PVE 8.2.2 ## Download Olares ISO image -Click [here](https://cdn.olares.com/) to download the official Olares ISO image. +Click [here](https://cdn.olares.com/olares-latest-amd64.iso) to download the official Olares ISO image. ## Configure VM in PVE diff --git a/docs/zh/manual/get-started/install-linux-iso.md b/docs/zh/manual/get-started/install-linux-iso.md index 93d5a2171..d13a9e47c 100644 --- a/docs/zh/manual/get-started/install-linux-iso.md +++ b/docs/zh/manual/get-started/install-linux-iso.md @@ -9,16 +9,20 @@ description: 通过官方 ISO 镜像在物理机上安装 Olares 系统，包括 ## 准备条件 - **宿主机要求**: - - **CPU**：4 核及以上。 + - **CPU**：4 核及以上，X86-64 架构（AMD 或 Intel）。ARM 芯片目前不支持 ISO 镜像安装。 - **内存**：至少 8 GB 可用内存。 - **存储**：至少 150 GB SSD（若使用机械硬盘 HDD，将导致安装失败）。 - **网络**：需连接至有线局域网。 - **其他**：不小于 **8 GB** 的 U 盘。 +::: tip 激活遇到问题？ +当前 ISO 镜像使用了国际版网络配置（使用 `olares.com` 域名）。如遇激活问题，请暂时切换至[一键安装脚本](install-linux-script.md)方式安装激活。 +::: + ## 制作启动盘 -1. 点击[此处](https://cdn.olares.cn)下载最新官方 Olares ISO 镜像。 +1. 点击[此处](https://cdn.olares.cn/olares-latest-amd64-cn.iso)下载最新官方 Olares ISO 镜像。 2. 下载并安装 [**Balena Etcher**](https://etcher.balena.io/) 工具。 3. 将 U 盘插入电脑。 4. 打开 Etcher，依次选择： diff --git a/docs/zh/manual/get-started/install-olares.md b/docs/zh/manual/get-started/install-olares.md index 6d22a5874..9c3aa9ffe 100644 --- a/docs/zh/manual/get-started/install-olares.md +++ b/docs/zh/manual/get-started/install-olares.md @@ -17,10 +17,8 @@ Olares 支持多平台、多部署方式。请根据你的使用场景选择最 推荐在 **Linux（Ubuntu 或 Debian）** 系统上运行 Olares，以获得最佳性能和稳定性。 -| 安装方式 | 说明 | -|-----------------------------------------|------| -| [**通过 ISO 镜像安装**](install-linux-iso.md) | 通过官方 ISO 镜像在物理机上全新安装 Olares，自动配置宿主（Linux）
环境、容器运行时、驱动及核心依赖。 | -| [**通过一行命令安装**](install-linux-script.md) | 在现有 Linux 系统中快速安装 Olares。 | +- [**ISO 镜像**](install-linux-iso.md) — 通过官方 ISO 镜像在物理机上全新安装 Olares，自动配置宿主（Linux）
环境、容器运行时、驱动及核心依赖。 +- [**一行命令**](install-linux-script.md) — 在现有 Linux 系统中快速安装 Olares。 :::tip 推荐 在主机上使用 ISO 安装方式可确保最佳的兼容性、性能与系统级优化，是运行 Olares 的首选方案。 @@ -31,31 +29,22 @@ Olares 支持多平台、多部署方式。请根据你的使用场景选择最 以下方式仅适用于**开发测试**或**轻量级环境**。 #### Linux - -- [**通过 Docker 镜像安装**](install-linux-docker.md)：在 Linux 上通过 Docker Compose 以容器化方式运行 Olares。 +- [**Docker 镜像**](install-linux-docker.md) — 在 Linux 上通过 Docker Compose 以容器化方式运行 Olares。 #### Windows - -| 安装方式 | 说明 | -|----------|--------------------------------------------------------| -| [**通过一行命令安装**](install-windows-script.md) | 在 Windows Subsystem for Linux 2（WSL 2）虚拟化环境中安装 Olares。 | -| [**通过 Docker 镜像安装**](install-windows-docker.md) | 在 WSL2 下的 Docker 容器中运行 Olares。 | +- [**一行命令**](install-windows-script.md) — 在 WSL2 虚拟化环境中安装 Olares。 +- [**Docker 镜像**](install-windows-docker.md) — 在 WSL2 的 Docker 容器中运行 Olares。 #### macOS - -| 安装方式 | 说明 | -|----------|-------------------------------| -| [**通过一行命令安装**](install-mac-script.md) | 使用 MiniKube 在容器化环境中安装 Olares。 | -| [**通过 Docker 镜像安装**](install-mac-docker.md) | 在 macOS 上通过 Docker 部署 Olares。 | +- [**一行命令**](install-mac-script.md) — 使用 MiniKube 在容器化环境中安装 Olares。 +- [**Docker 镜像**](install-mac-docker.md) — 在 macOS 上通过 Docker 部署 Olares。 #### PVE - -| 安装方式 | 说明 | -|----------|-----------------------------------------| -| [**通过 ISO 镜像安装**](install-pve-iso.md) | 在 Proxmox VE 中通过 ISO 镜像以虚拟机方式部署 Olares。 | -| [**通过一行命令安装**](install-pve-script.md) | 直接在 PVE 节点上安装 Olares。 | +- [**ISO 镜像**](install-pve-iso.md) — 在 Proxmox VE 中通过 ISO 镜像以虚拟机方式部署 Olares。 +- [**一行命令**](install-pve-script.md) — 直接在 PVE 节点上安装 Olares。 +- [LXC](install-lxc.md) - 在 PVE 环境下使用 Linux 容器 （LXC）部署 Olares。 #### Raspberry Pi（ARM） -- [**通过一行命令安装**](install-raspberry-pi.md)：在基于 ARM 架构的 Raspberry Pi 设备上安装 Olares。 +- [**一行命令**](install-raspberry-pi.md)：在基于 ARM 架构的 Raspberry Pi 设备上安装 Olares。 diff --git a/docs/zh/manual/get-started/install-pve-iso.md b/docs/zh/manual/get-started/install-pve-iso.md index 0e1d4454f..471bfb72b 100644 --- a/docs/zh/manual/get-started/install-pve-iso.md +++ b/docs/zh/manual/get-started/install-pve-iso.md @@ -19,13 +19,17 @@ description: 在 PVE 虚拟化平台上使用 ISO 镜像安装配置 Olares 的 ## 系统要求 请确保设备满足以下配置要求： -- CPU：4 核及以上 +- CPU：4 核及以上，X86-64 架构（AMD 或 Intel）。ARM 芯片目前不支持 ISO 镜像安装。 - 内存：不少于 8GB 可用内存 - 存储：不少于 200GB 的可用磁盘空间，需使用 SSD 硬盘安装。使用 HDD（机械硬盘）可能会导致安装失败。 - 支持的系统版本：PVE 8.2.2 +::: tip 激活遇到问题？ +当前 ISO 镜像使用了国际版网络配置（使用 `olares.com` 域名）。如遇激活问题，请暂时切换至[一键安装脚本](install-pve-script.md)方式安装激活。 +::: + ## 下载 Olares ISO 镜像 -点击[此处](https://cdn.olares.cn)下载官方 Olares ISO 镜像。 +点击[此处](https://cdn.olares.cn/olares-latest-amd64-cn.iso)下载最新官方 Olares ISO 镜像。 ## 配置 PVE 虚拟机 在 PVE 运行 Olares 时，请确保虚拟机满足以下配置要求。你可以在**创建新虚拟机**时应用这些设置，也可以**调整已有虚拟机**以符合要求。