网页端

网页端部署可以使用 docker 或者可执行文件，推荐使用 docker，会免去环境依赖的问题。

Docker 部署

使用 Docker Compose 部署

Docker Compose 是一个用来定义和运行多个容器的工具。在 docker-compose.yml 文件中，可以定义应用的服务、网络和卷等。

1. 在项目根目录下创建 compose.yml 文件，内容如下：

services:
  olived-web:
    container_name: olived-web
    image: olivedapp/olived-web:latest # 指定镜像
    pull_policy: always # 每次运行时拉取最新的镜像
    environment:
      - PUID=1000 # 用户ID
      - PGID=1000 # 用户组ID
      - TZ=Asia/Shanghai # 时区设置
    ports:
      - "9843:9843" # 映射端口
    volumes:
      - $PWD/olivedpro_downloads:/olivedapp/olivedpro_downloads # 映射下载文件夹
      - $PWD/.olivedpro:/olivedapp/.olivedpro # 映射配置文件夹

2. 在终端中运行以下命令启动服务：

docker-compose up -d

这将会根据 compose.yml 文件启动容器，并且将端口映射到 localhost:9843，您可以在浏览器中访问 http://localhost:9843/ 来访问应用。

使用 Docker 命令直接部署

如果不想使用 Docker Compose，也可以直接使用 docker run 命令启动容器：

docker run -d \
--name olived-web \
--pull always \
-e PUID=1000 \
-e PGID=1000 \
-p 9843:9843 \
-v $PWD/olivedpro_downloads:/olivedapp/olivedpro_downloads \
-v $PWD/.olivedpro:/olivedapp/.olivedpro \
olivedapp/olived-web:latest

这条命令将启动一个新的容器并映射端口和卷，确保容器可以访问主机上的文件。

详细解释

当使用 Docker 卷（-v 标志）时，可能会出现权限问题。通常，这是由于主机操作系统与容器之间的文件权限不一致导致的。

为了解决这个问题，我们可以通过设置容器内的用户 ID（PUID）和组 ID（PGID）来避免权限问题。您可以指定主机上的用户和组来确保容器内的文件权限一致。

例如，以下环境变量：

- PUID=1000
- PGID=1000

意味着容器内的文件将会由用户 ID 为 1000 和组 ID 为 1000 的用户来管理。您可以通过在主机中运行以下命令来查找您的用户 ID 和组 ID：

id your_user

该命令会输出类似于以下内容：

uid=1000(your_user) gid=1000(your_user) groups=1000(your_user)

根据输出的 uid 和 gid，您可以修改 docker-compose.yml 或 docker run 命令中的 PUID 和 PGID 值，确保容器中的文件与主机文件具有相同的权限。

可执行文件部署

执行下载的网页端可执行文件后，可以通过浏览器访问 http://localhost:9843/ 来访问 olived-web 服务。

在 Windows 上无法运行

如果您在 Windows 上运行时遇到应用无法识别或提示“应用无法启动”的问题，可以尝试以下解决方法：

1. 点击更多信息：点击提示框中的“更多信息”链接。
2. 点击“仍要运行”按钮：如果仍然无法运行，选择“仍要运行”继续执行。

这通常是因为 Windows 默认的安全设置阻止了某些未认证的应用程序。点击“仍要运行”后，应用程序应该能够正常启动。

在 MacOS 上无法运行

如果您在 MacOS 上遇到无法打开应用或提示“不安全”的问题，可以尝试以下操作：

1. 更改“安全性”设置

1. 打开 系统偏好设置。
2. 选择 安全性与隐私。
3. 在 常规 标签页下，找到 允许从以下位置下载的应用程序，并选择 任何来源。

2. 如果显示“应用已损坏”

如果系统提示应用已损坏或无法打开，可以按照以下步骤解决：

1. 打开您的 终端。
2. 执行以下命令，注意替换 /Applications/xxxx.app 为您的应用实际路径。确保应用名称中没有空格。如果有空格，可以先修改名称，再执行命令。

sudo xattr -d com.apple.quarantine /Applications/xxxx.app

3. 输入管理员密码后，按下回车键。
4. 重启应用程序，应该能够正常启动。