Redmine管理员基础手册专业资料.doc

Redmine 管理员手册 Redmine 管理员手册作者:北京群英汇信息技术有限公司网址:版本:1.0.0-8+日期:-07-29 12:23:45版权信息:目录 1阐明 2项目管理 3顾客管理 4顾客组管理 5LDAP 认证 6角色和权限 7问题跟踪系统 8自定义属性 9枚举值 10配备 11高档配备 o 11.1版本库配备 o 11.2发送邮件配备 o 11.3接受邮件 11.3.1方案 11.3.2各种方案详细阐明 11.3.2.1从邮件服务器转发邮件 11.3.2.2从IMAP服务器读取邮件 11.3.2.3从POP3服务器读取邮件 11.3.2.4从原则输入读取邮件 11.3.3启动匿名顾客通过邮件提交问题 11.3.4工作原理 11.3.5例子演示 o 11.4发送提示邮件 o 11.5LDAP 认证 o 11.6配备单点登录 o 11.7从LDAP同步账号 o 11.8Subversion 基于途径授权 1阐明关于手册中方框标记某些阐明 Note 是需要注意某些。 Hint 是群英汇为Redmine扩展某些。 2项目管理 项目列表默认状况下，项目列表显示所有活动项目。 要想浏览所有项目(涉及活动和归档项目)，需要调节项目状态过滤器为所有。项目列表截图 新建/编辑项目 项目存档在项目列表页面点击存档链接，可将该项目存档。存档项目对顾客不可见。 管理员可以取消存档。当父项目存档，它所有子项目也都自动存档。 复制既有项目在项目列表页面，点击复制链接复制你想要复制项目。复制项目表单将会预填原项目设立(如:跟踪标签，自定义属性 .)。 在该表单底部，你可以选取复制原项目哪些内容。 删除项目在项目列表页面，点击删除链接，界面将跳到删除页面，选中是复选框，然后点击删除按钮，该项目以及子项目所有数据都将被删除。Note存档与删除区别: 存档只是隐藏项目及子项目，而项目数据还存在。 删除则是将项目以及子项目数据一同删除，无法恢复 。 3顾客管理 顾客列表顾客列表截图默认状况下显示 活动 顾客，你可以调节顾客状态过滤器，选取浏览不同状态顾客。通过点击右侧锁定链接，可将顾客从 活动 状态变为 已锁定 状态。同样点击解锁链接，可以将顾客从 已锁定 状态变为 活动 状态。 添加顾客点击右上角新建顾客链接，跳转到新建顾客页面:必填字段:o 登录名o 名字o 姓氏o 邮件地址o 管理员选中之后，该顾客将是管理员身份。o 认证如果你已经配备了LDAP，那么认证区域将会浮现一种认证模式下拉选取框。 Redmine 提供了两种认证机制 内部认证将顾客密码通过加密后存入数据库中。 外部认证(如LDAP)顾客密码存储在某些外部认证中，如LDAP。o 给顾客发送账号信息选中它，创立账号后，新建顾客将收到一封关于账号信息邮件。Hint从LDAP同步账号RedmineLDAP认证模式是：一方面管理员配备好 LDAP认证 ，并且选中 即时顾客生成 选项，然后当顾客用LDAP账号第一次登录Redmine时，系统自动将LDAP里顾客信息存入数据库，为顾客创立Redmine账号。但这样会有一种问题：如果管理员想批量给某一项目添加项目成员，这时不得不一一告知这些人，让她们都立马登录一下Redmine(由于只有这样，她们才拥有Redmine账号，管理员才干给这些顾客划分角色，授予权限)。显然这很麻烦，给管理人员带来不必烦恼，似乎管理人员权利需要员工予以。群英汇给Redmine管理人员带来了福音，咱们添加了管理人员可以直接从LDAP服务器同步账号到Redmine功能。事实上，如果配备了外部认证源（LDAP或者单点登录），点击“新建顾客”，会直接跳转到 LDAP 帐号同步界面。操作环节，参见 从LDAP同步账号 。 编辑顾客想要编辑顾客信息，只需点击顾客名，就跳转到修改该顾客信息页面了。o 普通属性和新建顾客界面属性同样。o 组如果你创立了组，在这里会显示组选项卡。o 项目在这里可以给该顾客指定项目。4顾客组管理顾客组列表截图从Redmine-0.9 开始，管理员可以定义顾客组。顾客组可以像添加常规顾客同样添加到项目中去。当把顾客添加到一种已存在顾客组里，该顾客将拥有该组一切权限。5LDAP 认证在1.0此前，新建LDAP需要一系列繁杂操作：管理 - 配备 - 认证 - LDAP认证（右下角处）。为了以便顾客操作，固将LDAP操作置于管理员界面右边栏。6角色和权限角色决定顾客在项目中拥有权限。 每个项目成员在项目中可以有一种或者各种角色。 每个顾客在不同项目中可以有不同角色。管理员可以创立新角色；也可以编辑已经存在角色；只有当某一角色下没有顾客时,该角色才干被删除。 角色属性o 名称o 问题可指派给此角色如果不选，问题就不能指派给该角色里成员。o 从如下选项复制工作流程新建角色可以从已经存在角色中复制工作流，如果不选则新建角色工作流为空。 权限当编辑一种角色时候，你可以通过(选中/取消)那些不同行为给该角色定义权限。权限描述项目权限新建项目容许非管理顾客创立根项目编辑项目容许顾客编辑项目属性选取项目模块容许顾客启动/禁用项目模块管理成员容许顾客添加/删除项目构成员或者变化项目构成员角色管理版本容许顾客添加/删除项目版本新建子项目容许顾客为该项目创立子项目讨论区权限管理讨论区容许顾客添加/编辑/删除项目讨论区刊登贴子容许顾客在讨论区刊登贴子编辑贴子容许顾客编辑任何贴子、删除贴子附件编辑自己贴子仅容许顾客编辑自己贴子删除贴子容许顾客删除任何贴子和回答删除自己贴子仅容许顾客删除自己贴子和回答文档权限管理文档容许顾客添加/编辑/删除项目文档查看文档容许顾客查看文档文献权限管理文献容许顾客添加/编辑/删除项目文献查看文献容许顾客查看文献问题跟踪权限管理问题类别容许顾客添加/编辑/删除问题类别查看问题容许顾客查看问题新建问题容许顾客新建问题更新问题容许顾客编辑问题管理问题关联容许顾客添加/删除问题之间关联管理子任务容许顾客给问题（issues）添加/删除子任务添加阐明容许顾客给已存在问题添加阐明编辑阐明容许顾客编辑任何问题阐明编辑自己阐明仅容许顾客编辑自己添加问题阐明移动问题容许顾客将已存在问题移动到别项目中删除问题容许顾客删除问题管理公开查询容许顾客添加/编辑/删除公开问题查询保存查询容许顾客保存自定义问题查询查看甘特图容许顾客浏览甘特图查看日历容许顾客浏览日历查看跟踪者列表容许顾客查看问题跟踪者添加跟踪者容许顾客给已存在问题添加跟踪者删除跟踪者容许顾客删除问题跟踪者新闻权限管理新闻容许顾客添加/编辑/删除项目新闻为新闻添加评论容许顾客给新闻添加评论版本库权限管理版本库容许顾客配备项目版本库浏览版本库容许顾客浏览并查看项目版本库内容查看变更容许顾客查看变更集访问提交信息予以Redmine.pm具备访问项目版本库写权限时间跟踪权限登记工时容许顾客给项目登记工时查看耗时容许顾客查看项目耗时历史编辑耗时容许顾客编辑任何耗时记录编辑自己耗时仅容许顾客编辑自己耗时记录管理项目活动容许顾客添加/编辑/删除活动Wiki权限管理Wiki容许顾客创立/删除项目Wiki 删除Wiki页面是 不可恢复 操作，它会删除所有有关页面及附件重命名Wiki页面容许顾客重命名Wiki页面，或者指定Wiki页面父页面删除Wiki页面容许顾客删除Wiki页面，此操作是 不可恢复 ，页面以及修改历史将被统统删除查看Wiki容许顾客查看Wiki页面导出Wiki页面容许顾客将Wiki页面导出为各种格式（pdf,html,.)查看Wiki历史记录容许顾客老版本Wiki页面，或者查看不同版本之间差别编辑Wiki页面容许顾客编辑没有保护Wiki页面删除附件容许顾客删除Wiki页面附件保护Wiki页面容许顾客锁定/解锁Wiki页面，并具备编辑已锁定WIki页面权限 系统角色在Redmine共有2种系统角色，她们供Redmine内部使用，因而不能被删除。o Non member非项目成员角色，用于定义那些不属于该项目成员顾客权限。o Anonymous匿名角色，用于定义匿名顾客在项目中权限。Note 这两个角色仅被用于公开项目，因而匿名顾客和非私有项目成员顾客不能看到它。 某些权限不能赋给这两个角色。 例如 管理成员 7问题跟踪系统 跟踪标签新建跟踪标签截图跟踪标签代表不同问题类型。 默认状况下有三种标签：错误，功能和支持。管理员可以新建跟踪标签:o 名称o 在路线图中显示问题o 从如下选项复制工作流程新建跟踪标签可以从已经存在跟踪标签中复制工作流。如果不选，那么新建跟踪标签工作流为空。o 项目可以指定新建跟踪标签用于哪些项目中。 问题状态管理员可以依照需要自由地添加和删除问题状态。问题状态具有属性:o 名称o 已关闭问题如果选中，则表达处在该状态问题属于已经关闭问题 (可以声明各种状态属于已关闭状态)。o 默认值指定新建问题默认状态 (只能有一种状态属于默认状态)。 完毕度该选项（即问题状态一览表中 完毕度 列）只有在 计算问题完毕度 选项设立为 使用问题状态 时才显示。 更新问题完毕度该链接只有在 计算问题完毕度 选项设立为 使用问题状态 时才显示。当点击该链接后，系统将依照问题状态更改问题完毕度。后来每当问题状态更新，系统自动依照这里设立完毕度更改完毕度字段值。设立问题状态相应完毕度 工作流工作流使你可以定义不同角色项目成员对不同类型问题所能做问题状态变更。定制工作流截图在工作流设立页面，选取你想要编辑角色和跟踪标签，点击编辑按钮，跳转到编辑页面，此页面可以编辑该角色对该标签所能做变更状态。 左侧列出了该跟踪标签所有状态，你可以在右侧选取针对该状态该角色可以变更状态。Note要变化问题状态，顾客需要具备 更新问题 或者 添加阐明 权限。（参见 权限 ）。8自定义属性自定义属性截图Redmine容许管理员给如下实体添加属性，从而给这些实体添加额外描述信息: 问题 耗时 项目 版本库 顾客 组 活动(时间跟踪) 问题优先级 文档类别 自定义属性有如下几种数据类型: 整数 字符串单行输入框 文本多行输入文本域 日期 布尔值复选框 列表下拉列表自定义属性约束条件: 最小-最大长度决定自定义属性字段长度(0表达没有限制)。 正则表达式通过指定正则表达式，对自定义属性内容进行验证。 默认值自定义属性默认值 跟踪标签设立该自定义属性可以在哪些跟踪标签中使用 必填该自定义属性与否是必填字段 用于所有项目该自定义属性与否用于所有项目中 作为过滤条件该自定义属性与否作为过滤器过滤条件 可用作搜索条件该自定义属性与否可以用作搜索时搜索条件9枚举值枚举值截图Redmine容许管理员对如下实体添加枚举值，从而扩充这些实体可选取值: 活动(时间跟踪) 问题优先级 文档类别 这些枚举值是跨项目管理员可以任意地添加/修改/删除。枚举值包括字段: 名称 活动只有活动枚举值才干被使用 默认值如果选中，那么在使用同类枚举值时该枚举值默认被选中同一类枚举值默认值只能设立一种10配备 普通o 应用程序标题显示在应用程序头部文字o 欢迎文字这些文本将显示在项目概述页面o 附件大小限制上传文献最大值。 默以为5120KBo 每页显示条目个数设立这个重要用于分页显示，在这里可以填入你想要每页显示记录数，各种值之间用逗号分开。 默认值:25,50,100o 在项目活动中显示天数在这里可以设立每页显示多少天之内活动 默认值:30 表达显示30天之内活动o 主机名称在这里设立Redmine服务主机名称和途径。 Redmine用这个值生成邮件签名里URL，从而收件人通过点击邮件签名里URL访问系统。o 合同合同指邮件告知里生成链接打开方式。 默认值:http邮件里链接是“guessed”，因而不会诊断你使用是不安全Http合同还是安全https合同。o 文本格式格式文本用于问题，新闻，文档，Wiki等等描述字段。默认只有 textile 一种文本过滤器。o 缓存格式化文本(1.0加入功能)每次向浏览器发送格式化文本（例如：问题描述，wiki页面.）时都需要将原始文本转换成HTML。如果文本过于庞大，那么这个过程将会很慢。该设立容许你启动缓存格式化文本。缓存文本存储方案取决于缓存方略设立（可以功过config.action_controller.cache_store设立）。默认状况下，缓存方略为 MemoryStore如果你需要启动缓存，强烈建议你使用另一种缓存方略，像MemCacheStore或者FileStore（在内存有限状况下）。更多关于Rails缓存方略可参照手册： 压缩Wiki历史文档对Wiki历史进行压缩(减小数据库存储大小)。 默认值:禁用 RSS Feed内容条数限制RSS feeds内容条数最大值。 默认值:15 容许直接显示最大文本文献限制可直接显示文本文献最大尺寸 默认值:512KB 查看差别页面上显示最大行数限制可最多显示差别行数最大值，多于最大行数内容将被Redmine自动截断 默认值:1500 显示o 主题可供选取主题样式Redmine除默认主题外还提供了此外两个备用主题: alternate该主题最大特点是依照问题优先级在问题列表页面为问题着色。 classic该主题追溯到Redmine 0.5.1，给人一种典型感觉o 默认语言当应用程序不能辨认顾客浏览器语言时，默认语言将被作为客户端语言。当发送邮件时也会依照默认语言作为给顾客发送邮件语种。默认值:eno 日历开始于设立星期开始日期，提供选项有: 依照顾客语言 星期一 星期天 默认值:依照顾客语言o 日期格式设立日期显示格式: 依照顾客语言依照顾客语言定义格式显示 其她格式默认值:依照顾客语言o 时间格式设立时间显示格式: 依照顾客语言 其她格式 默认值:依照顾客语言o 顾客显示格式设立顾客名显示格式o 使用Gravatar顾客头像如果启动，在应用程序某些地方可以看到顾客Gravatar头像o 默认Gravatar头像设立那些没有Gravatar图片顾客显示图片 认证o 规定认证如果选中，匿名顾客将不能访问系统，顾客必要登录后才干访问。o 自动登录o 容许自注册设立与否容许顾客注册: 禁用不容许顾客注册 通过邮件认证激活账号顾客注册后将收到一封激活账号邮件，里面具有一种激活账号链接，点击那个链接就能激活刚注册账号。 手动激活账号 默认值顾客注册后需要经管理员审核批准。顾客注册后，管理员会收到一封激活账号邮件。 自动激活账号顾客注册成功后，直接就能用刚注册账号登录系统。 最短密码长度设立密码最短长度 默认值:4o 忘掉密码如果选中，在登录界面上将显示一种忘掉密码链接。 默认值:启动o 容许使用OpenID登录和注册设立与否容许使用OpenID登录和注册Note使用该功能需要安装ruby-openid包，一条简朴gem 安装命令就能搞定(安装后需要重启服务生效):gem isntall ruby-openido 启用REST web service设立与否启用REST web service在和外部系统集时才需要启动该选项 项目o 新建项目默以为公开项目默认状况下，新建项目为公开项目你可以在创立项目时不选中该选项，从而创立非公开项目，也可以修改已创立公开项目为非公开项目。o 新建项目默认启用模块设立新建项目默认启动模块o 顺序产生项目的记选中之后，Redmine将为你提供持续项目的记符。该标记符用于Redmine REST架构URL标记用o 非管理员顾客新建项目时将被赋予（在该项目中）角色该选项用于指定非管理顾客在新建项目中角色。如果你不指定，系统自动把该顾客指定为新建项目 管理员角色 。Note前提是你必要在 权限 设立界面为非管理员顾客赋予创立项目权限 问题跟踪o 容许不同项目之间问题关联如果选中，那么不同项目之间问题可以建立关联。 默认值:禁用o 在项目页面上默认显示子项目问题如果选中，在浏览父项目问题列表达，日历和甘特图时子项目问题也显示出来。 默认值:启动 计算问题完毕度设立计算问题完毕度方案:o 使用问题(完毕度)属性 默认值 ：顾客手动设立完毕度 o 使用问题状态：每个问题状态可以被设立一种完毕度。该设立会启动问题状态设立页面 完毕度 和 更新问题完毕度 设立。 问题输出条目限制设立导出问题条目最大值(涉及CSV和PDF)。 默认值:500 问题列表中显示默认列设立默认状况下，问题哪些列被显示。顾客自定义属性只有标记为 用于所有项目 才会在这里列出供选取 邮件告知o 邮件发件人地址设立Redmine发送邮件发件人地址o 使用密件抄送(bcc)密件抄送即邮件头部隐藏接接受者地址o 纯文本(无HTML)如果选中，则邮件仅发送纯文本格式，不发送HTML格式o 选取需要发送邮件告知动作设立Redmine哪些活动事件会触发邮件告知o 邮件签名如何配备发送邮件，参见 配备邮件发送 接受邮件o 在这些行之后截断邮件这些设立可以删除接受邮件签名某些o 启用用于接受邮件服务从 0.8 之后，Redmine支持通过发送邮件创立问题和评论。想要使用此功能，你需要启动接受邮件API。 默认值:禁用 API key点击生成一种key链接，系统自动生成一种key，这是Redmine通过接受邮件创立问题密钥。 如何配备通过接受邮件提交问题，参见 Redmine 接受邮件配备 版本库o 自动获取程序变更如果选中，当顾客浏览版本库时应用程序会自动抓取版本库新变更 默认值:启动管理员可以关闭此选项，通过使用cron在后台定期执行 Repository#fetch_changesets 命令抓取版本库新变更。 例如:ruby script/runner Repository.fetch_changesets -e production你也可以通过版本库 post-commit 或者 post-receive 钩子调用这个任务，从而使每次提交之后，变更集自动被抓取。o 启用用于版本库管理Web Service该选项只有在你安装了自动创立SVN版本库脚本时启动。 默认值:禁用o 启用 SCM设立启动SCM类型o 版本库编码设立版本库里文献编码方式(各种值之间用逗号分开)。 这些编码用于将文献内容和diff转换成UTF-8，从而保证浏览版本库时对的显示。当填写各种编码方式时，第一种编码是文献使用编码o 提交注释编码o 在文献变更记录页面上显示最大修订版本数量 默认值:100o 在提交信息中引用和解决问题当版本库抓取变更集时，会扫描提交信息中引用和解决问题ID。o 在这里管理员可以定义提交注释中引用和解决问题核心字，从而通过使用这些核心字自动使该次修订引用或者解决某些问题。 同样可以设立使用解决问题核心字后问题状态变更,以及完毕度变更 * 默认核心字有: 引用：refs，references，IssueID 解决：fixes，closes 用于解决问题核心字后问题变更设立: 应用后状态 完毕度 示例This commit refs #1，#2 and fixes #3阐明: 这次代码提交引用了问题 1,2 同步解决了问题 3 每个核心字和问题ID之间可以用空格，逗号或者&分开 11高档配备11.1版本库配备 常规信息Redmine始终以来支持不同版本控制工具集成：Subversion，CVS，Mercurial，Darcs，Git和Bazaar。一方面你要在Redmine主机上安装适当二进制包，并保证这些二进制文献在PATH环境变量中可用:SCM已测试过版本阐明Subversion1.3 & 1.4 & 1.5 & 1.6需要1.3或者更高版本CVS1.12.12需要1.12,不能同步使用CVSNTMercurial0.9.3Bazaarl.0.0.candidate.1 & 2.0.4Darcs1.0.7Git1.5.4.2例如，如果你想用Redmine访问Subverion版本库，你必要在Redmine主机上安装SVN二进制文献。 给项目添加一种已经存在版本库在项目配备选项卡下有 版本库 子选项库，在这里可觉得项目添加版本库。选取你所使用版本库类型，并输入版本库途径或者URLNote当配备完版本库第一次访问时，Redmine将抓取版本库中已经存在所有提交信息，并存入数据库。因此如果你版本库特别大，那么该过程将会很长。为了避免这种状况，你可以将该过程放在后台执行。在配备完版本库后，运营下面命令:$ ruby script/runner Repository.fetch_changesets -e production所有提交将会被存入数据库从Redmine0.9之后，你还可以通过一种链接给某一项目或者所有项目执行 fetch_changesets:(给所有活动项目取回变更集)(仅给foo项目取回变更集) Subversion 版本库Redmine支持合同有(http:,svn:,file:)，只需要输入版本库URL例如:http:/host/path/to/the/repository如果版本库需要身份认证，你需要额外输入顾客名和密码Note如果你想要用 svn+ssh:/ 访问版本库，你必要把svn+ssh配备为非交互方式。同步需要设立ssh认证 public/private 钥对HintSubversion 基于途径授权Redmine对Subversion授权是这样解决：在配备Subversion版本库时，除了输入URL外，还需填写一种拥有Subversion读权限账户信息(如果你Subversion不容许匿名访问)。 显然诸多商业公司代码有很高严密性，大多是不容许匿名访问,看来是必填了。 而Redmine对Subversion认证不严格也是从这里开始。 填写了这个账户之后，不论哪个顾客登录Redmine浏览版本库，看到版本库信息都是该账户应当能看到，而不是当前登录顾客应当看到。 也就是说，在这种状况下，如果你想对代码浏览严加控制，那么就需要创立一种很低权限Subversion账号，用这个账号作为Redmine访问Subversion账号。 但这样一来，那些具备高权限顾客就不乐意了(她们本来是能看到诸多代码，但这样一来她们权限无形之中被剥夺了)。为了满足商业软件公司需求，群英汇对Redmine关于Subversion授权某些进行了扩展，采用Subversion自身授权模式。 咱们添加理解析Subversion授权文献组件，可以较好地解析每个顾客权限，从而保证Redmine浏览权限和Subversion定义权限一致，完美解决了Redmine中Subversion授权不严格问题，实现了Subversion基于途径授权。配备环节，参见 Subversion基于途径授权 CVS 版本库输入:o 版本库URL (也可以输入途径或者链接字符串，例如 :pserver) o 模组名称 示例:pserver:login:passwordhost:/path/to/the/repository如下几种版本库输入版本库途径即可 Git 版本库 Mercurial 版本库Hint解决了中文版Mercurial版本库无法使用问题由于Redmine在匹配Mercurial版本信息时是基于英语匹配，因此当咱们使用中文Mercurial时，它会抛出匹配失败异常，导致中文顾客不能使用。 Bazaar 版本库 Darcs 版本库11.2发送邮件配备一方面将 config/email.yml.example 重命名为 config/email.yml然后配备发送邮件需要参数:production: delivery_method：:smtp smtp_settings: address：mail.foo.bar port：25 domain：foo.bar # authentication：:login # user_name：xxx # password：xxx注意：用#注销掉那三行信息，是邮件服务器身份验证信息。但是如果你顾客已经使用了域验证，就不需要那三行信息。访问redmine，以管理员身份登录系统，点击管理-配备-邮件告知，然后点击右下角发送测试邮件，就可以测试你邮件服务配备与否成功了。Note当delivery_method设立为:smtp时，它解决流程是这样:在触发邮件发生事件发生后，一方面发送邮件，直到邮件发送完毕，页面才跳转。这就是说在发送邮件过程中，页面始终处在等待状态。 那么有无一种异步发送邮件机制呢?在Redmien 0.9 之后，可通过将delivery_method设立为：async_smtp，这时发送邮件和页面跳转属于不同线程，当触发邮件事件发生后，发送邮件将会通过消息队列在后台执行，而页面继续向下执行，不用等到邮件发送完毕。11.3接受邮件从Redmien-0.8.0 开始，通过配备，你可以以发送邮件方式创立或者评论问题(issue)。11.3.1方案你可以通过如下几种方式配备Redmine接受邮件功能: 从邮件服务器转发邮件 o 长处：与远程邮件服务器协作，邮件解决即时，迅速(无环境重载) o 缺陷：需要某些邮件传播代理(MTA)配备(如Postfix，Sendmail.) 从IMAP或者POP3服务器读取邮件 o 长处：易于安装，不需要配备邮件传播代理(MTA)，与远程邮件服务器协作 o 缺陷：邮件解决不即时(需要添加一种定期读取邮件 con job) 从原则输入读取邮件 o 长处：用于测试最佳选项 o 缺陷：慢(每次读取邮件时都要重新载入环境)，需要配备邮件传播代理(MTA) 11.3.2各种方案详细阐明11.3.2.1从邮件服务器转发邮件用一种独立脚本转发邮件服务器发来邮件。这个脚本从原则输入读取原始邮件并通过HTTP祈求转发给Redmine。 该脚本在redmine目录下：extra/mail_handler/rdm-mailhandler.rb 使用这项功能之前，你需要启动接受邮件API:启动操作：管理-配备-接受邮件，选中启动接受邮件服务复选框,并点击链接生成一种key,产生一种密钥。 复制 rdm-mailhandler.rb 到你邮件服务器，保证该脚本有执行权限并配备你邮件传播代理(MTA)。 rdm-mailhandler 用法: rdm-mailhandler options -url= -key= 必要选项: -u，-url Redmine服务URL -k，-key Redmine API key 惯用可选选项: -h，-help 显示协助信息 -v，-verbose 显示额外信息 -V，-version 显示版本信息 问题属性可控选项: -p，-project=PROJECT 项目的记符 -t，-tracker=TRACKER 跟踪标签类型 -category=CATEGORY 问题类别名称 -priority=PRIORITY 优先级名称 -o，-allow-override=ATTRS 容许在邮件里覆盖先前已指定属性，各种属性之间用逗号分开 示例: # 没有指定项目，那么在邮件内容里必要包括“Project”核心字，否则Redmine将不解决该邮件 rdm-mailhandler -url -key secret # 设立默认项目和跟踪标签类型，同步可以在邮件内容里覆盖tracker和priority选项 rdm-mailhandler -url -project foo -tracker 错误 -allow-override tracker,priority 下面是一种Postfix例子: foo：|/path/to/rdm-mailhandler.rb -url -key secret -project foo11.3.2.2从IMAP服务器读取邮件redmine提供了一种rake任务(redmine:email:receive_imap)负责从IMAP服务器读取邮件。当cron 运营该rake命令时你需要使用选项 -f /path/to/redmine/appdir/Rakefile，由于不这样话会浮现找不到rakefile异常。下面是一种定期每30分钟读取一次邮件cron文献:*/30 * * * * redmineuser rake -f /path/to/redmine/appdir/Rakefile redmine:email:receive_imap RAILS_ENV=production host=imap.foo.bar username= password=xxx如果你设立正常工作，但经常收到cron daemon发送邮件，你可以在rake命令后添加 -silent选项禁止执行命令输出信息。下面是禁止每次执行cron命令时发送邮件示例:*/30 * * * * redmineuser rake -f /path/to/redmine/appdir/Rakefile -silent redmine:email:receive_imap RAILS_ENV=production host=imap.foo.bar username= password=xxx阐明：在 cron 文献中,这个命令必要位于一行上如果用Windows作为服务器，pycron可以用于调度读取邮件任务。 同步需要你修改防火墙设立，打开同通过TCP链接IMAP143端口。可用IMAP选项:host=HOST IMAP服务主机(*默认值：127.0.0.1*)port=PORT IMAP服务端口(*默认值：143*)ssl=SSL 与否使用SSL？(*默认值：false*)username=USERNAME IMAP账号password=PASSWORD IMAP密码folder=FOLDER 将要读取IMAP文献夹(*默认值：INBOX*)move_on_success=MAILBOX 将已成功读取邮件移动到MAILBOX中， 而不是删除掉move_on_failure=MAILBOX 将Redmine忽视邮件移动到MAILBOX中问题(issue)属性可控选项:project=PROJECT 项目的记符tracker=TRACKER 跟踪标签类型category=CATEGORY 问题类别名称priority=PRIORITY 优先级名称allow_override=ATTRS 容许在邮件内容里覆盖先前已指定属性，各种属性之间用逗号隔开rake命令一种例子:# 没有指定项目， 这时邮件内容里必要包括Project核心字rake redmine:email:receive_imap RAILS_ENV=production host=imap.foo.bar username= password=xxx# 指定默认项目和跟踪标签类型， 同步容许在邮件里覆盖tracker和priority属性值# both tracker and priority attributes:rake re