# Redmine快速入门

<br>

<figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/zh/redmine/redmine-gui-websoft9.jpg" alt=""><figcaption></figcaption></figure>

### 准备[​](https://support.websoft9.com/docs/redmine#%E5%87%86%E5%A4%87) <a href="#zhun-bei" id="zhun-bei"></a>

部署 创达睿通 提供的 Redmine 之后，需完成如下的准备工作：

1. 在云控制台获取您的 **服务器公网IP地址**
2. 在云控制台安全组中，确保 **Inbound（入）规则** 下的 **TCP:80** 端口已经开启
3. 在服务器中查看 Redmine 的 **默认账号和密码**
4. 若想用域名访问 Redmine **域名五步设置** 过程

### Redmine 初始化向导[​](https://support.websoft9.com/docs/redmine#init) <a href="#init" id="init"></a>

#### 详细步骤[​](https://support.websoft9.com/docs/redmine#%E8%AF%A6%E7%BB%86%E6%AD%A5%E9%AA%A4) <a href="#xiang-xi-bu-zhou" id="xiang-xi-bu-zhou"></a>

1. 使用本地 Chrome 或 Firefox 浏览器访问网址：*<http://域名>* 或 *<http://服务器公网IP>*, 进入Redmine主页。
2. 点击【登录】，进入系统&#x20;

   <figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/zh/redmine/redmine-login-websoft9.png" alt=""><figcaption></figcaption></figure>
3. 进入 Redmine 控制台，系统提示修改密码&#x20;

   <figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/zh/redmine/redmine-resetpwf-websoft9.png" alt=""><figcaption></figcaption></figure>
4. 打开：【项目】，新建一个项目&#x20;

   <figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/zh/redmine/redmine-createproject-websoft9.png" alt=""><figcaption></figcaption></figure>
5. 通过：【管理】>【配置】>【显示】，设置 Redmine 项目区语言&#x20;

   <figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/zh/redmine/redmine-language-websoft9.png" alt=""><figcaption></figcaption></figure>
6. 通过：【管理】>【配置】>【用户】，设置 Redmine 用户语言（区别于项目区语言）&#x20;

   <figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/en/redmine/redmine-userlanguage-websoft9.png" alt=""><figcaption></figcaption></figure>
7. 激活新注册用户：通过【管理】>【用户】，在【状态】选项中选择 已注册用户，然后激活用户，该用户才能登陆。

> 需要了解更多 Redmine 的使用和配置，请参考官方文档：Redmine guide

#### 出现问题？[​](https://support.websoft9.com/docs/redmine#%E5%87%BA%E7%8E%B0%E9%97%AE%E9%A2%98) <a href="#chu-xian-wen-ti" id="chu-xian-wen-ti"></a>

若碰到问题，请第一时刻联系 **技术支持**。也可以先参考下面列出的问题定位或 **FAQ** 尝试快速解决问题：

**Redmine能打开，但总是出现502错误**

Redmine 所需内存最低为2G，若服务器配置较低或并发访问超过服务器计算能力，会出现502错误

### Redmine 使用入门[​](https://support.websoft9.com/docs/redmine#redmine-%E4%BD%BF%E7%94%A8%E5%85%A5%E9%97%A8) <a href="#redmine-shi-yong-ru-men" id="redmine-shi-yong-ru-men"></a>

下面以 **Redmine 管理项目** 作为一个任务，帮助用户快速入门：

1. 登录 Redmine，依次打开：【项目】>【创建项目】&#x20;

   <figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/zh/redmine/redmine-createproject001-websoft9.png" alt=""><figcaption></figcaption></figure>
2. 填写上面标题和英文缩写，保存&#x20;

   <figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/zh/redmine/redmine-createproject002-websoft9.png" alt=""><figcaption></figcaption></figure>
3. 打开项目页面，开始工作&#x20;

   <figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/zh/redmine/redmine-createproject003-websoft9.png" alt=""><figcaption></figcaption></figure>
4. 安装插件，增加更多所需的功能

### Redmine 常用操作[​](https://support.websoft9.com/docs/redmine#redmine-%E5%B8%B8%E7%94%A8%E6%93%8D%E4%BD%9C) <a href="#redmine-chang-yong-cao-zuo" id="redmine-chang-yong-cao-zuo"></a>

#### 配置 SMTP[​](https://support.websoft9.com/docs/redmine#smtp) <a href="#smtp" id="smtp"></a>

1. 在邮箱管理控制台获取 SMTP 相关参数
2. 通过 SFTP 连接服务器，修改 `configuration.yml` 文件，找到 “production:”, 在 production 下面添加并完善你的 SMTP 参数:

   ```
   production:
   delivery_method: :smtp
   smtp_settings:
      address: smtp.exmail.qq.com
      port: 465
      ssl: true
      enable_starttls_auto: true
      domain: imdcinsights.com
      authentication: :login
      user_name: help@imdcinsights.com
      password: ********

   ```

   > 注意缩进/空格,按照规定格式配置，否则Redmine报错
3. 重启 Redmine 服务后生效

   ```
   sudo docker restart redmine
   ```
4. 配置系统主机：【管理】-【配置】-【一般】-【主机名称】

![](https://libs.websoft9.com/Websoft9/DocsPicture/zh/redmine/redmine-sethost-websoft9.png)

5. 配置系统邮件发件人地址：【管理】-【配置】-【邮件通知】-【邮件发件人地址】,保存，点击最下方“发送测试邮件”进行测试

   <figure><img src="/files/SY564u3k4HctNH0oX3vV" alt=""><figcaption></figcaption></figure>

Redmine 官方提供了数十种不同 SMTP 配置方法，请参考官方文档： Email Configuration

#### 插件管理[​](https://support.websoft9.com/docs/redmine#%E6%8F%92%E4%BB%B6%E7%AE%A1%E7%90%86) <a href="#cha-jian-guan-li" id="cha-jian-guan-li"></a>

通过 Redmine 提供的插件中心可以扩展它的功能：

**安装插件**

下面以一个具体的插件为例说明如何安装插件：

1. 进入Ajax Redmine Issue Dynamic Edit 插件页面，获取其下载地址
2. 使用 SFTP 登录服务，分别运行如下命令

   ```
   # 进入 Redmine 目录
   cd /data/wwwroot/redmine
   wget https://www.redmine.org/attachments/download/25386/redmine_issue_dynamic_edit.zip
   unzip redmine_issue_dynamic_edit.zip 
   docker cp redmine_issue_dynamic_edit redmine:/usr/src/redmine/plugins
   ```
3. 重启 Redmine 容器服务

   ```
   sudo docker restart redmine
   ```
4. 登陆 Redmine 控制台查看插件&#x20;

   <figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/zh/redmine/redmine-installplugindy-websoft9.png" alt=""><figcaption></figcaption></figure>

**卸载插件**

1. 使用 SFTP 删除 /data/wwwroot/redmine/plugins 对应的插件
2. 重启 Redmine 容器生效

   ```
   sudo docker restart redmine
   ```

#### LDAP[​](https://support.websoft9.com/docs/redmine#ldap) <a href="#ldap" id="ldap"></a>

参考官方文档：<https://www.redmine.org/projects/redmine/wiki/RedmineLDAP>

### Redmine 参数[​](https://support.websoft9.com/docs/redmine#parameter) <a href="#parameter" id="parameter"></a>

Redmine 应用中包含 Nginx, Docker, MySQL, phpMyAdmin 等组件，可通过 **通用参数表** 查看路径、服务、端口等参数。

通过运行`docker ps`，可以查看到 Redmine 运行时所有的 Container：

```
CONTAINER ID   IMAGE               COMMAND                  CREATED          STATUS          PORTS                                                  NAMES
635cd1609242   phpmyadmin:latest   "/docker-entrypoint.…"   21 minutes ago   Up 21 minutes   0.0.0.0:9090->80/tcp, :::9090->80/tcp                  phpmyadmin
bcd0b75f04d7   redmine:4.2         "bash -c 'cat /my_cm…"   21 minutes ago   Up 21 minutes   0.0.0.0:9001->3000/tcp, :::9001->3000/tcp              redmine
b171c341fa90   mysql:5.7           "docker-entrypoint.s…"   21 minutes ago   Up 21 minutes   0.0.0.0:3306->3306/tcp, :::3306->3306/tcp, 33060/tcp   redmine-db
```

#### 路径[​](https://support.websoft9.com/docs/redmine#path) <a href="#path" id="path"></a>

Redmine 安装目录：*/data/apps/redmine*\
Redmine 站点目录：*/data/apps/redmine/data/redmine*\
Redmine 配置目录：*/data/apps/redmine/data/redmine/config*\
Redmine 配置文件：*/data/apps/redmine/data/redmine/config/configuration.yml*

> configuration.yml 是容器首次启动时基于 configuration.yml.example 而创建的

#### 端口[​](https://support.websoft9.com/docs/redmine#port) <a href="#port" id="port"></a>

无特殊端口

#### 版本[​](https://support.websoft9.com/docs/redmine#version) <a href="#version" id="version"></a>

```
docker inspect redmine:latest |grep REDMINE_VERSION |head -1 |cut -d= -f2
```

#### 服务[​](https://support.websoft9.com/docs/redmine#service) <a href="#service" id="service"></a>

```
sudo docker start | stop | restart redmine
sudo docker start | stop | restart redmine-db
sudo docker start | stop | restart phpmyadmin
```

#### 命令行[​](https://support.websoft9.com/docs/redmine#cli) <a href="#cli" id="cli"></a>

[Redmine-CLI](https://pypi.org/project/Redmine-CLI/)

#### API[​](https://support.websoft9.com/docs/redmine#api) <a href="#api" id="api"></a>

[Redmine API](https://www.redmine.org/projects/redmine/wiki/Rest_api)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.imdcinsights.com/ying-yong-zhong-xin/xie-zuo-yu-sheng-chan-li/redmine-kuai-su-ru-men.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.