跳到主要内容
版本:1.0

快速入门

Canvas 是一个基于云端的开源在线学习系统(LMS),使学校能够构建数字学习环境,以应对远程教学趋势。Canvas简化了教学,提高了学习效率,并消除了支持和发展传统学习技术的麻烦。它具有开放,直观的特点,通过所有数字工具和内容,简化老师的教学,让学生获得更简单的互联网学习体验。

准备

部署 Websoft9 提供的 Canvas 之后,需完成如下的准备工作:

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

Canvas 初始化向导

详细步骤

  1. 使用本地电脑的 Chrome 或 Firefox 浏览器访问网址:http://域名 或 http://服务器公网IP, 进入登录页面 canvas 登录

  2. 输入账号密码(不知道账号密码?),成功登录到 Canvas 后台
    canvas 后台

  3. 依次打开:【管理员】>【设置】>【账户设置】设置语言
    canvas 设置语言

  4. 依次打开:【账户】>【设置】>【编辑设置】修改默认邮件账户和密码 canvas 修改账号 canvas 修改密码

  5. 开放注册:【管理员】>【身份验证设置】>【提供者】开放教师和学生注册 canvas 开放注册

出现问题?

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

Canvas 访问速度很慢?

Canvas 对服务器的配置要求极高,最低配置为2核8G

Canvas 使用入门

下面以 使用 Canvas 构建学习管理系统 作为一个任务,帮助用户快速入门:

Canvas 常用操作

重置 Canvas 至初始状态

如果你忘记了 Canvas 管理员密码,又无法通过邮件找回密码,重置至 Canvas 初始状态。

使用 SSH 连接服务器,重置环境变量后开始初始化:

  export RAILS_ENV=production
export [email protected]
export CANVAS_LMS_ADMIN_PASSWORD=websoft9
export CANVAS_LMS_ACCOUNT_NAME=admin
export CANVAS_LMS_STATS_COLLECTION=opt_in
cd /data/wwwroot/canvas; bundle exec rake db:initial_setup

为防止初始化删除历史数据,建议先做备份

配置 SMTP

  1. 在邮箱管理控制台获取 SMTP 相关参数

  2. 使用 SSH 登录服务器,修改邮件配置文件文件后保存

    production:
    address: smtp.163.com
    port: 465
    user_name: [email protected]
    password: #wwBJ8
    authentication: plain # plain, login, or cram_md5
    domain: smtp.163.com
    outgoing_address: [email protected]
    default_name: Instructure Canvas

    以上配置如果不能收到邮件,请尝试将 authentication 改为 login**

  3. 给 Canvas 配置域名,并确保可以访问

    配置域名很重要,否则即使收到邮件,里面的链接也无法打开。

  4. 给 Canvas 配置 HTTPS 访问(可选),否则打开邮件中的链接时会有安全提示

  5. 重启 Apache 服务后生效

    sudo systemctl restart apache

很多用户反馈,Canvas部署在中国大陆之外(比如香港)区域,方可成功发出邮件。原因未知。

Canvas 更换域名

如果 Canvas 需要更换域名,除 Canvas 配置文件之外,还需修改 Canvas 根目录下 .htaccess 中域名有关的值。

Canvas 安装插件

通过BigBlueButton为例,步骤如下:

  1. 登陆 Canvas 站点

  2. 通过URL:http://域名/plugins 或 http://服务器公网IP/plugins, 进入插件选择页面 canvas 插件

  3. 选择您要安装的插件,点击安装

  4. 在插件安装页面,去掉勾选【禁用此插件】,输入相关引导信息,点击【申请】 canvas 插件设置 canvas 插件设置

  5. 安装插件前后,页面已经发生变化(课程中追加了BigBlueButton对应的会议功能) canvas 插件安装前后对比 canvas 插件安装前后对比

参数

Canvas 应用中包含 Ruby, Node.js, Apache, Passenger, Docker, Redis, PostgreSQL, PgAdmin 等组件,可通过 通用参数表 查看路径、服务、端口等参数。

通过运行docker ps,可以查看到 Canvas 运行时所有的 Container:

CONTAINER ID        IMAGE               COMMAND                  CREATED             STATUS              PORTS                                NAMES

下面仅列出 Canvas 本身的参数:

路径

Canvas 安装目录: /data/wwwroot/canvas
Canvas 日志目录: /data/wwwroot/canvas/log
Canvas 配置目录: /data/wwwroot/canvas/config
Canvas 域名配置文件:/data/wwwroot/canvas/config/domain.yml
Canvas 域名配置文件:/data/wwwroot/canvas/config/outgoing_mail.yml

端口

无特殊端口

版本

控制台查看

服务

# 通过 Apache 服务启停来管理 Canvas
sudo systemctl start | stop | restart | status apache

# Canvas Job
sudo systemctl start | stop | restart | status canvas-init

命令行

Canvas 提供一序列脚本工具,脚本目录: /data/wwwroot/canvas/script

Passenger 应用服务器提供了命令行工具 passenger

API

Canvas API Documentation