港湾指南

安装与运行

使用 Docker 安装

1. 下载并安装 Docker：根据你的操作系统选择合适的 Docker 版本进行安装。
2. 启动 Docker 服务：确保 Docker 服务已经启动并在后台运行。
3. 拉取港湾指南镜像：

   docker pull registry.cn-hangzhou.aliyuncs.com/leiyu1988/portainer:latest
   

4. 运行港湾指南容器：

   docker run -d --name portainer -p 9000:9000 registry.cn-hangzhou.aliyuncs.com/leiyu1988/portainer:latest
   

5. 访问港湾指南：打开浏览器，访问 http://localhost:9000 即可。

使用镜像安装

1. 下载港湾指南镜像：

   docker pull registry.cn-hangzhou.aliyuncs.com/leiyu1988/portainer:latest
   

2. 运行镜像：

   docker run -d --name portainer -p 9000:9000 registry.cn-hangzhou.aliyuncs.com/leiyu1988/portainer:latest
   

3. 访问港湾指南：打开浏览器，访问 http://localhost:9000 即可。

功能概览

核心功能

• 容器管理：通过图形界面查看和管理所有运行的 Docker 容器。
• 网络管理：配置和管理 Docker 网络设置。
• 卷管理：管理与容器相关的存储卷。
• 日志监控：实时查看容器的日志输出，支持日志清理功能。

高级功能

• 多环境支持：支持在不同环境中部署和管理容器。
• 团队协作：通过团队权限设置，实现多人协作开发。
• 自动化构建：集成 CI/CD 工具，实现自动化的代码构建和部署。
• 监控与报警：实时监控容器运行状态，支持自定义报警规则。

快速开始

创建第一个容器

1. 进入港湾指南界面：
   • 打开浏览器，访问 http://localhost:9000。
2. 选择“新建容器”：
   • 填写容器名称、镜像地址等信息。
3. 启动容器：
   • 点击“启动”，等待容器运行起来。

部署一个简单的 Web 应用

1. 创建新项目：
   • 在港湾指南中，新建一个项目。
2. 添加 Docker Compose 文件：

   version: '3'
   services:
     web:
       image: nginx:latest
       ports:
         80:80
   

3. 部署项目：
   • 点击“部署”，等待项目运行起来。
4. 访问应用：
   • 打开浏览器，访问 http://localhost 即可看到 Nginx 的欢迎页面。

使用说明

常见问题

• 如何停止一个容器？
  • 在港湾指南界面，找到目标容器，点击“停止”按钮。
• 如何删除一个容器？
  • 在港湾指南界面，找到目标容器，点击“删除”按钮。
• 如何查看容器日志？
  • 在港湾指南界面，找到目标容器，点击“日志”标签即可查看。

提示与技巧

• 批量操作：支持一次选择多个容器进行批量启动、停止或删除操作。
• 快捷键：在容器列表页面，使用快捷键可以快速筛选和排序容器。
• 插件扩展：港湾指南支持多种插件扩展功能，如日志清理、自动备份等。

代码统计

统计脚本

1. 下载 cloc.sh 脚本：
   • 在项目根目录下找到 cloc.sh 文件。
2. 安装 cloc 工具：

   sudo apt install cloc  # 适用于 Debian/Ubuntu 系统
   brew install cloc      # 适用于 macOS 系统
   

3. 运行统计脚本：

   ./cloc.sh
   

令牌计数

工具生成

1. 生成工具 JSON 文件：
   • 在项目根目录下，运行以下命令：

     go run cmd/portainer/main.go
     

2. 统计令牌使用情况：
   • 使用生成的 JSON 文件进行进一步分析和统计。

附录

环境变量

• 设置环境变量：
  • 在 Docker 运行命令中添加环境变量，例如：

    docker run -d --name portainer -p 9000:9000 -e PORTAINER_ENV=prod registry.cn-hangzhou.aliyuncs.com/leiyu1988/portainer:latest
    

安全注意事项

• 访问控制：
  • 确保港湾指南运行在受信任的网络环境中。
  • 配置强密码或使用 SSH 密钥进行身份验证。

通过以上步骤，你可以快速上手并充分利用港湾指南的强大功能。如有任何问题或需要进一步的帮助，请随时查阅文档或联系支持团队。